repospace / README.md
2Btainment's picture
Initial RepoSpace MVP: FastAPI + constrained sandbox + React UI
3c07134 verified
|
Raw History Blame Contribute Delete
1.66 kB
metadata
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).