Github url


by warner

get things from one computer to another, safely

10.9K Stars 415 Forks Last release: Not found MIT License 1.5K Commits 34 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Magic Wormhole

PyPIBuild StatusWindows Build Statuscodecov.ioDocs

Get things from one computer to another, safely.

This package provides a library and a command-line tool named


, which makes it possible to get arbitrary-sized files and directories (or short pieces of text) from one computer to another. The two endpoints are identified by using identical "wormhole codes": in general, the sending machine generates and displays the code, which must then be typed into the receiving machine.

The codes are short and human-pronounceable, using a phonetically-distinct wordlist. The receiving side offers tab-completion on the codewords, so usually only a few characters must be typed. Wormhole codes are single-use and do not need to be memorized.

For complete documentation, please see or the docs/ subdirectory.

This program uses two servers, whose source code is kept in separate repositories: themailbox server, and thetransit relay.

License, Compatibility

Magic-Wormhole is released under the MIT license, see the


file for details.

This library is compatible with Python 3.5 and higher (tested against 3.5, 3.6, 3.7, and 3.8). It also still works with Python 2.7.

Packaging, Installation

Magic Wormhole packages are included in many operating systems.

Packaging status

To install it without an OS package, follow the Installation docs.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.