Magic Wormhole

Open source

Magic Wormhole is a Python library and command-line tool for safely sending files, folders or text between two computers using short codes.

magic-wormhole.readthedocs.io
Magic Wormhole homepage screenshot
GitHub stars
23k
Last 30 days
+113(+0%)
Last commit
6 days ago
Repository age
11 years
Licence
MIT
Self-hosted
Yes

About Magic Wormhole

Magic Wormhole is a Python package that provides a library and a command-line tool named wormhole. It moves files and directories of any size, or brief snippets of text, between two computers. The two ends are matched by an identical wormhole code: the sending machine generates and shows it, and the receiving person types it in. It is released under the MIT license.

Codes are short, single-use and human-pronounceable, drawn from a phonetically distinct word list, and the receiving side offers tab completion so usually only a few characters are needed. Nothing has to be memorized. The program relies on two servers, a mailbox server and a transit relay, whose source code lives in separate repositories. The library works with Python 3.10 and newer, packages exist in many operating systems, and complete documentation is on Read the Docs along with a PyCon 2016 talk.

Key features

  • Send files, folders or text between computers
  • Short single-use pronounceable codes
  • Tab completion for entering codes
  • Python library and wormhole CLI
  • Mailbox server and transit relay components
  • Packaged for many operating systems

Good fit for

  • Sending a file to a colleague without accounts
  • Moving a directory between two of your machines
Built with
Python tools
Tags
file-transfer
python
command-line
cli
p2p
secure-transfer
encryption
sharing

Magic Wormhole: questions and answers

What is Magic Wormhole used for?
Magic Wormhole is a Python library and command-line tool for safely sending files, folders or text between two computers using short codes. It is a good fit for sending a file to a colleague without accounts and moving a directory between two of your machines.
Is Magic Wormhole open source?
Yes. Magic Wormhole is open source under the MIT licence. Its source code is on GitHub at magic-wormhole/magic-wormhole and is written mainly in Python.
Is Magic Wormhole free?
Yes. Magic Wormhole is open source, so the software itself is free to use.
What is Magic Wormhole an alternative to?
Magic Wormhole is an open-source alternative to WeTransfer, Send Anywhere, MASV and Signiant. Other open-source alternatives to WeTransfer include croc, Safebucket and Plik.
Is Magic Wormhole actively maintained?
Yes. The most recent commit to Magic Wormhole was on 6 November 2026. The project has 23k stars on GitHub, with 113 added in the last 30 days.

Open-source alternatives to Magic Wormhole

See all

SaaS alternatives to Magic Wormhole

See all