# StudioSwarm

> The Zero-Cloud, Zero-Subscription P2P File Swarm & NLE Timeline Sync for Video Creators.

StudioSwarm is a high-performance web application and peer-to-peer file transfer engine engineered for filmmakers, video editors, colorists, and digital imaging technicians (DITs). It transfers massive raw video files (50 GB–500 GB+ ProRes, BRAW, RED RAW) and NLE project files directly from NVMe SSD to NVMe SSD over encrypted WebSockets and 4-lane WebRTC data channels with zero cloud storage, zero upload wait, and zero subscription fees.

## Core Features
- **Zero-Cloud & Zero-Subscription**: No cloud servers, no intermediate storage buckets, no recurring storage fees.
- **Priority Playhead Scrubbing**: Preview and stream 4K video instantly before the entire file finishes downloading.
- **Client-Side E2EE (AES-GCM-256)**: Encryption keys are strictly isolated in the URL `#` hash fragment and never touch signaling servers.
- **O(1) RAM File System Access**: Streams 100 GB+ files directly to disk via the Chromium File System Access API without browser memory bloat.
- **4-Lane Multipath SCTP Striping**: Bypasses TCP/SCTP Head-of-Line blocking with Shortest-Queue-First adaptive routing.
- **In-Browser AI Agent API (`window.StudioSwarmAgent`)**: Autonomous programmatic driver for AI agents (Claude Computer Use, web bots, Playwright).

## How AI Agents Use StudioSwarm
AI agents can automate end-to-end file transfers by opening `/app` and interacting with the `window.StudioSwarmAgent` JavaScript object:

```javascript
// 1. Sender Agent creates an encrypted ticket:
const ticket = await window.StudioSwarmAgent.createTicket({ folderName: "DAILIES_DAY_01" });
// -> Send ticket.url ("http://host/app#r=...&k=...") to the recipient agent

// 2. Recipient Agent accepts the ticket and streams direct to disk:
await window.StudioSwarmAgent.acceptTicket(ticket.url, { destinationMode: "OPFS_FALLBACK" });

// 3. Monitor progress or inspect early pieces:
window.StudioSwarmAgent.on("progress", (data) => console.log(`${data.progressPct}%`));
window.StudioSwarmAgent.on("complete", (receipt) => console.log("Done!", receipt));
```

## Key URLs & Endpoints
- Web Application (with `window.StudioSwarmAgent`): /app
- Promotional Portal & Documentation: /
- Machine-Readable Agent Manifest: /api/agent-manifest.json
- Health Check: /health
- User Registration: /api/auth/register
- User Sign In: /api/auth/login (Demo Testing Account: `demo` / password: `demo`)
- Stripe 7-Day Free Trial Checkout: /api/billing/create-checkout-session
- Subscription & Trial Status: /api/billing/status
- Full Agent Documentation: /llms-full.txt