magic-wormhole

magic-wormhole: Transfer Files Safely Between Computers

Magic Wormhole is a Python library and command-line tool for sending files, directories, or short text between computers using a one-time, human-readable code. It is useful when you want a simple transfer without exchanging a permanent account or memorizing credentials.

View on GitHub Compare
Stars
23k
Forks
759
Stars, last 30 days
+108

Our take

Health score

55/100

How it is scored
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.

Selected snapshot

Stars

23,109

Forks

769

Change 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.
ProjectLanguageLicenseStarsStatus
magic-wormholePythonMIT23kNot checked yet
wushGoCC0-1.01.5kInactive

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.

Comparisons