# BYOC

> BYOC ("Bring Your Own Computer") makes a browser tab a small real-time server. One tab calls host() and shares a link; other tabs call connect(link) and talk to it peer to peer over WebRTC, with automatic TURN and encrypted-relay fallback, reconnection after host reloads, and readable diagnostics. No backend, no deploy step, no account: import it from a CDN in a single HTML file. Connections are WebSocket-like.

Import: `import { host, connect } from 'https://byoc.infinitefun.com/v0/byoc.js';`

Best for 2–16 people in real-time, session-length apps (games, quizzes, whiteboards, pair editing). The room's logic runs in the host's tab; the host must keep the tab open and visible.

## Docs

- [The whole API on one page](/llm.md): host(), connect(), Room, Connection, options, diagnostics, error codes, patterns and pitfalls.
- [Wire protocol v1](/protocol.md): for implementing operators or other SDKs.

## Examples

- [Chat](/examples/chat.html): host-or-guest in one file, loopback for the host, backlog for late joiners.
- [Whiteboard](/examples/whiteboard.html): host keeps the canonical state and syncs new guests.