--- title: RepoSpace emoji: 🚀 colorFrom: indigo colorTo: blue sdk: docker app_port: 7860 pinned: false license: mit short_description: Live browser previews for GitHub repos --- # RepoSpace Temporary, instantly usable live environments for GitHub repositories in the browser. **MVP loop:** paste a GitHub URL → validate/clone → build → iframe preview → auto-shutdown after 15 minutes of inactivity. ## Honest scope (Hugging Face Space) This is a **production-shaped MVP** on HF Docker (`cpu-basic`). It does **not** run Firecracker MicroVMs or EKS. Previews use a **constrained subprocess sandbox** (timeouts, soft resource limits, localhost port pool, no privileged Docker-in-Docker). | Works well | Usually fails honestly | |------------|-------------------------| | Static HTML / prebuilt `dist` | Full Next.js servers | | Simple Vite/React `build` → static | Large Docker-only apps | | Tiny Flask / FastAPI / Streamlit | Heavy installs over time/memory budget | See `SPEC.md` for blueprint → HF deltas. ## API - `POST /api/sessions` `{ "repo_url": "https://github.com/owner/repo" }` - `GET /api/sessions/{id}` - `GET /api/sessions/{id}/logs` - `DELETE /api/sessions/{id}` - Live proxy: `/s/{id}/` Optional `github_token` for private repos — **never logged** (docs use `[ERSATZ_KEY]`). ## Security highlights - Untrusted code only in child processes - Path traversal blocked; rate limits by IP - Secrets redacted in logs - Auto-teardown: 15 min inactivity / 60 min hard cap ## UI English product UI (i18n-ready). Dark modern layout: RepoInputBar, StatusBadge, BuildTerminalBox, PreviewFrame. Built for **2Btainment** (Rob Boss).