NeoRun Documentation
Launch any GitHub repo in seconds with AI-powered build analysis.
NeoRun clones your repo, analyzes it with Gemini AI, builds it in an isolated Docker container, and exposes a running preview — all in under 60 seconds.
Key Features
- Zero Config — No Dockerfile needed. NeoRun’s AI agents detect your stack and generate build instructions automatically.
- GPU Support — Run ML models, Stable Diffusion, LLM inference, and more with NVIDIA GPU passthrough.
- Instant Preview — Every deployment gets a unique
*.pods.neorun.devsubdomain with HTTPS. - Real-time Logs — Watch your build progress live with streaming logs and AI-powered error recovery.
- Web Terminal — SSH-like access to your running container directly from the browser.
- Idle Auto-Shutdown — Free-tier pods auto-stop after 30 minutes of inactivity to save resources.
Architecture
| Component | Stack | Purpose |
|---|---|---|
| Frontend | Next.js 15, TypeScript, Tailwind | Dashboard, deployment wizard, pod management |
| Worker | Python, FastAPI, Docker SDK | Build orchestration, container lifecycle, GPU management |
| Database | Supabase (PostgreSQL + Auth) | Projects, jobs, pods, user management |
| Queue | Redis | Job dispatch with priority lanes |
Getting Started
Head to the Quickstart guide to deploy your first project.
Last updated on