Development Quick Start (1 Minute Setup)

For macOS/Linux developers who want fast local development.

TL;DR

# Setup (first time only)
./dev-setup.sh

# Start development
./dev.sh

# Open http://localhost:3000

# Stop when done
./dev-stop.sh

What You Get

✅ Backend on http://localhost:8000 ✅ Frontend on http://localhost:3000
✅ Hot reload for both ✅ Auto-restart on file changes ✅ API docs at http://localhost:8000/docs

Requirements

Python 3.13 (brew install python@3.13 on macOS)
uv (auto-installed by setup script)
Node.js 18+
FFmpeg (brew install ffmpeg on macOS)

Why This is Faster Than Docker

Feature	Local Dev	Docker
Startup	2-5 sec	10-30 sec
Hot Reload	Instant	1-2 sec
File Changes	Native speed	Volume overhead

Commands

./dev-setup.sh     # Setup once
./dev.sh           # Start both servers
./dev-stop.sh      # Stop servers
./dev-backend.sh   # Backend only
./dev-frontend.sh  # Frontend only

Logs

tail -f logs/backend.log
tail -f logs/frontend.log

That's it! See LOCAL_DEV_GUIDE.md for more details.

1.2 KiB Raw Blame History