magic-wormhole: Transfer Files Safely Between Computers
Summary
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.
At a glance
- Language
- Python
- License
- MIT
- Stars
- 23k
- Forks
- 759
- Added to OSRepos
- December 12, 2025
- Last analyzed
- October 3, 2026
Topics
Click on any tag to explore related repositories
Use at your own risk
OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.
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.
Project Facts
- Language: Python
- License: MIT
- Stars: 23k
- Forks: 759
- Topics: none listed
- Archived: no
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.
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.
Source repository
Open the original repository on GitHub.
35 counted GitHub visits
Related repositories
Similar repositories that may be relevant next.
web-design: A Claude Code SKILL for Spec-First Web Page Design
October 3, 2026
The web-design project is a Claude Code SKILL designed to streamline the creation of beautiful and consistent web pages. It emphasizes a 'spec first, code second' approach, ensuring design principles are established before development begins. This tool helps generate UI, visuals, motion, and responsiveness that are consistent across pages and easily editable.
OOMWOO: Build Your Own Open-Source, Hackable Robot Vacuum Cleaner
October 2, 2026
OOMWOO is an ambitious open-source project enabling users to build their own robot vacuum cleaner using Raspberry Pi, 3D printing, and ROS2. It emphasizes local operation, hackability, and integration with Home Assistant, providing a high-quality, customizable home appliance. This project aims to deliver a fully open hardware, software, and firmware solution for autonomous home cleaning.
Shepherd: Reversible Execution Traces for Programmable Meta-Agents
October 2, 2026
Shepherd is a Python runtime substrate designed for agent work requiring inspection, reversibility, and supervision. It records agent runs as durable, inspectable execution traces, enabling meta-agents to observe, fork, replay, and revert any operation. This framework couples agents and environments using a copy-on-write fork, offering significant performance benefits and robust permission enforcement.
Agent Anvil: CI-First Evaluation Harness for Tool-Using AI Agents
October 1, 2026
Agent Anvil is a robust, CI-first evaluation harness designed for AI agents that utilize tools. It meticulously runs scenario suites, captures detailed traces of agent behavior, and provides semantic grading to identify issues. The platform excels at clustering failures and suggesting concrete fixes for prompts, tools, and guardrails, ensuring agents behave safely and effectively.