warp

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 10 Open GitHub ↗

Send files directly between devices. P2P WebRTC, encrypted, no uploads.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# WARP

### Send it straight through.

Peer-to-peer file transfer that **never touches a server**. Pick a file, share a code, and your bytes stream **device-to-device** over an encrypted WebRTC channel. No uploads, no accounts, no size limits, no cloud.

<p>
<a href="https://warp.ishannaik.com"><b>⚡ warp.ishannaik.com</b></a>
&nbsp;·&nbsp;
<a href="https://warp.ishannaik.com/how">How it works</a>
&nbsp;·&nbsp;
<a href="https://github.com/Ishannaik/warp/issues">Issues</a>
&nbsp;·&nbsp;
<a href="https://discord.gg/KKvtRhQvRv">Discord</a>
</p>

[![CI](https://github.com/Ishannaik/warp/actions/workflows/ci.yml/badge.svg)](https://github.com/Ishannaik/warp/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-5360ff.svg)](https://raw.githubusercontent.com/Ishannaik/warp/main/LICENSE)
[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/KKvtRhQvRv)
![Built with WebRTC](https://img.shields.io/badge/WebRTC-P2P-5360ff)
![Cloudflare](https://img.shields.io/badge/Cloudflare-Pages%20%2B%20Workers-ef6a3d)
![Cost](https://img.shields.io/badge/cost-%240%20%C2%B7%20no%20card-1f9d55)

<br/>

`peer-to-peer` · `end-to-end encrypted` · `no size cap` · `no account` · `multi-device` · `$0`

<br/>

</div>

---

## ⭐ Star Warp · 🛠 Contribute

[![GitHub stars](https://img.shields.io/github/stars/Ishannaik/warp?style=flat&logo=github&color=5360ff)](https://github.com/Ishannaik/warp/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/Ishannaik/warp?style=flat&logo=github&color=5360ff)](https://github.com/Ishannaik/warp/network/members)
[![GitHub issues](https://img.shields.io/github/issues/Ishannaik/warp?color=ef6a3d)](https://github.com/Ishannaik/warp/issues)
[![PRs welcome](https://img.shields.io/badge/PRs-welcome-1f9d55.svg)](https://raw.githubusercontent.com/Ishannaik/warp/main/CONTRIBUTING.md)
[![License: MIT](https://img.shields.io/github/license/Ishannaik/warp?color=5360ff)](https://raw.githubusercontent.com/Ishannaik/warp/main/LICENSE)
[![Made with TypeScript + React](https://img.shields.io/badge/made%20with-TypeScript%20%2B%20React%2019-5360ff?logo=typescript&logoColor=white)](https://raw.githubusercontent.com/Ishannaik/warp/main/web)

</div>

Warp is open source and **we welcome PRs**, from a one-line typo fix to engine work.

- ⭐ **[Star the repo](https://github.com/Ishannaik/warp)**. It helps more people find serverless, $0 file transfer.
- 🛠 **[Read CONTRIBUTING.md](./CONTRIBUTING.md)**. Dev setup in two commands, an architecture tour ([docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md)), and a first-PR walkthrough.
- 🌱 **[Grab a good first issue](https://github.com/Ishannaik/warp/issues?q=is:open+label:%22good%20first%20issue%22)**. Each one is scoped, self-contained, and picked for newcomers.

---

## Governance & privacy

Warp is MIT-licensed, and its privacy guarantee comes from its architecture rather than a policy promise. The project's $0, no-TURN, and no-storage constraints keep file bytes out of Warp's infrastructure; introducing a hosted file relay or storage tier would require a visible architecture change, not a quiet policy edit. See [SECURITY.md](./SECURITY.md) and [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md) for the trust boundary and technical design.

## Why it's different

- 🔒 **End-to-end encrypted by default.** Every transfer rides DTLS on the WebRTC data channel, and the keys live only in the two browsers. Your ISP, the café Wi-Fi, and Warp itself all see nothing but ciphertext.
- 🛰️ **No server in the path.** The signaling server only *introduces* two peers, then steps aside. It never sees, stores, or relays a single file byte.
- ⚡ **Fast.** 256 KB SCTP chunks with backpressure push the channel toward your real link rate. Multi-GB games and zips **stream straight to disk** instead of buffering in RAM.
- 🌐 **True multi-device.** A room is a full mesh. **Fan one file out to every device at once**, or send back the other way. The channel stays open for more.
- ✋ **You stay in control.** The receiver gets a **review → accept → tray** flow. Nothing auto-downloads, so you choose what to save, per file or as a zip. Cancel mid-transfer and it stops **instantly** (the cancel rides the signaling socket, jumping the byte queue).
- 💸 **$0 and no credit card.** Warp runs on Cloudflare's free tier plus public STUN. No paid relay sits anywhere in the stack, so nothing can bill you.

> 📖 The [**theory page**](https://warp.ishannaik.com/how) walks the whole stack (NAT, STUN, DTLS, chunking, backpressure), then works down layer by layer through *why a relay can never be free*, all the way to thermodynamics.

## How it works

Warp is two small pieces:

- **`web/`** is the app plus landing page (Vite + React 19 + TypeScript + Tailwind v4). It runs entirely in the browser.
- **`server/`** is a **Cloudflare Worker + Durable Object** doing WebSocket **signaling**. It brokers the connection handshake and **hibernates when idle**, so it costs nothing between transfers.

```
  Browser A  ──handshake──▶   signaling (introduce only)   ◀──handshake──  Browser B
      └──────────────  encrypted WebRTC data channel · your files  ──────────────┘
```

1. You open a room, and the server mints a short code.
2. A friend joins with the code (or scans the QR), and the server introduces you.
3. The browsers connect directly (STUN for NAT discovery) and files stream **peer-to-peer, end-to-end encrypted**.

Devices on the **same network** also discover each other, grouped by public IP à la Snapdrop. Multiple peers can share one room as a mesh, up to `MAX_PEERS`.

### Deliberate non-goals

- **No TURN relay.** If both peers sit behind strict or symmetric NATs and can't punch through, Warp shows an **honest error** instead of paying to relay your bytes. Same Wi-Fi always works, and most networks connect fine via STUN.
- **No cloud storage.** Warp uploads nothing, so there's nothing to leak, expire, or get billed for.
- **No paid infrastructure.** Signaling is a free hibernating Worker, STUN is public, and file bytes go straight peer-to-peer.

## Quickstart

```bash
pnpm install

pnpm dev:server     # signaling (wrangler dev) on :8787
pnpm dev            # web app on :5173
```

```bash
pnpm --filter @warp/web build     # lint + typecheck + production build
pnpm --filter @warp/server test   # signaling e2e
```

## Self-hosting

- **Frontend** → any static host. We ship `web/` to **Cloudflare Pages**:
  ```bash
  cd web && wrangler pages deploy dist --project-name=<your-project>
  ```
- **Signaling** → a **Cloudflare Worker + Durable Object**, free on the Workers Free plan, no credit card, hibernates when idle:
  ```bash
  pnpm --filter @warp/server run deploy
  ```

Point `VITE_SIGNALING_URL` in the frontend at your signaling server's `wss://` URL (see [`web/.env.example`](./web/.env.example)). Vite inlines it at build time, so rebuild after changing it.

## Architecture & protocol

Receive behavior varies by browser capability and file size; see the [browser support and receive-strategy matrix](./docs/BROWSER-SUPPORT.md) for the current disk, OPFS, IndexedDB, and memory paths.

See [`server/README.md`](./server/README.md) for the signaling protocol: message contract, room lifecycle, and mesh rules.

## Brand

Logo marks live in [`web/public/brand/`](./web/public/brand) as SVG and PNG: a universal accent tile plus transparent light/dark glyphs.

## Contributing

PRs welcome. See [CONTRIBUTING.md](./CONTRIBUTING.md). Found a security issue? See [SECURITY.md](./SECURITY.md).

## License

warp

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README