Our take
- Activity
- 36
- Community
- 69
- Issues
- 69
- Pull requests
- 46
+108 stars in the last 30 days
- More contributors than 75% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
23,109Forks
769Change since Nov 16, 2026: +3 stars·+1 forks
Overview
Magic Wormhole helps people transfer files, directories, or short text from one computer to another. The sender displays a short code, and the recipient enters it on their machine to connect the two endpoints.
It is suited to occasional, direct handoffs where a memorable one-time code is more convenient than setting up a shared account or transfer workflow. The project includes a Python library as well as the wormhole command-line tool, and relies on separate mailbox and transit relay server projects.
Key Features
- Transfers arbitrary-sized files and directories, as well as short pieces of text.
- Pairs sending and receiving computers with a single-use code.
- Uses short, pronounceable codewords rather than requiring a long identifier to be copied.
- Offers tab-completion for codewords on the receiving side.
- Provides both a command-line interface and a Python library.
- Uses separate mailbox and transit relay servers for coordination and data transfer.
Use Cases
- A developer sends a file from a workstation to another computer without setting up a persistent file-sharing service.
- A colleague shares a directory with a recipient who can enter the displayed code on their own machine.
- Someone transfers a short piece of text between computers during a brief, one-off task.
- Python developers embed wormhole transfer capabilities in software using the library.
Getting Started
Install the package using the installation documentation, then use the wormhole command-line tool. See the README and full documentation for usage details.
Alternatives
- wush: wush transfers files over WireGuard peer-to-peer connections and also provides shell access, rather than using Magic Wormhole's one-time codes.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| magic-wormhole | Python | MIT | 23k | Not checked yet |
| wush | Go | CC0-1.0 | 1.5k | Inactive |
Considerations
- Both endpoints need to coordinate through a wormhole code, so the recipient must be available to enter it.
- The project depends on separate mailbox and transit relay server projects; this repository is the client library and command-line tool, not those server implementations.
- The README states compatibility with Python 3.10 and higher, and reports testing through Python 3.12.
- The project is MIT-licensed and is not archived.
Found this useful?
Share it with someone who would like magic-wormhole.