magic-wormhole/magic-wormhole
# Magic Wormhole [](https://pypi.python.org/pypi/magic-wormhole)  [](https://ci.appveyor.com/project/warner/magic-wormhole) [](https://codecov.io/github/magic-wormhole/magic-wormhole?branch=master) [](https://magic-wormhole.readthedocs.io) [](https://web.libera.chat/) [](https://matrix.to/#/#magic-wormhole:matrix.org) Get things from one computer to another, safely. This package provides a library and a command-line tool named `wormhole`, 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. * PyCon 2016 presentation: [Slides](http://www.lothar.com/~warner/MagicWormhole-PyCon2016.pdf), [Video](https://youtu.be/oFrTqQw0_3c) For complete documentation, please see https://magic-wormhole.readthedocs.io or the docs/ subdirectory. This program uses two servers, whose source code is kept in separate repositories: the [mailbox server](https://github.com/magic-wormhole/magic-wormhole-mailbox-server), and the [transit relay](https://github.com/magic-wormhole/magic-wormhole-transit-relay). ## License, Compatibility Magic-Wormhole is released under the MIT license, see the `LICENSE` file for details. This library is compatible with Python 3.10 and higher (tested against versions up to 3.12). ## Packaging, Installation Magic Wormhole packages are included in many operating systems. [](https://repology.org/project/magic-wormhole/versions) To install it without an OS package, follow the [Installation docs](https://magic-wormhole.readthedocs.io/en/latest/welcome.html#installation).