RAPP — Single-File Vibe Swarm Builder

Why this exists

Most agent frameworks are servers, dashboards, and yaml graphs. RAPP is the opposite: one HTML file, a directory of .py agents, and a runtime that lets you chat with any combination of them. Fork it, drop your own agents in, and you have a personal swarm in five minutes.

What it actually does

Hosts a chat UI that can route messages to one or many agents at once
Persists conversation memory in localStorage — refresh-proof, no backend
Hot-loads any .py file from /agents/ as a callable agent
Talks to models via the GitHub Copilot SDK, so anyone with a GitHub login can run the whole thing without managing keys
Ships the runtime, the catalog (RAPP_Store), and the agent registry (RAR) as a single coherent stack

How to vibe-code your own variant

Fork kody-w/RAPP
Drop a new agent file into /agents/your_agent.py
Open index.html locally — your agent is already in the picker
Iterate by talking to Claude/Copilot inside the agent file itself

The whole loop is "fork → edit a file → reload the page." That's the vibe.

Build me a single-file HTML application that hosts a swarm of AI agents, where each agent is its own .py file dropped into a /agents directory. No build step, no API keys required — use GitHub Copilot SDK for the model calls. The HTML page should let me chat with any combination of agents, persist memory across sessions in localStorage, and let me hot-load new agents by dropping a python file into the folder. Treat this like a runtime, not a demo: I want to fork it and use it as the substrate for everything.

What I learned shipping it

Single-file HTML is the new mainframe — fork-once, run-anywhere beats any framework choice.

Treating each agent as its own .py file gave me Lego blocks instead of a monolith. Composability is in the file system.

Copilot SDK means no API key wrangling — anyone with a GitHub login can run the swarm. That's the unlock.