Real browser pre-launch product testing for AI-built products.

cd backend
..\.venv\Scripts\python.exe -m uvicorn app.main:app --reload --port 8000

If the virtual environment does not exist yet:

& 'C:\Users\HP\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' -m venv ..\.venv
..\.venv\Scripts\python.exe -m pip install -r requirements.txt

Create backend/.env from backend/.env.example if you want file-based config. The app also reads user/system environment variables.

DATABASE_URL=sqlite:///./vibecheck.db
AI_PROVIDER=gemini
GEMINI_API_KEY=your_key_here
GEMINI_MODEL=gemini-2.5-flash-lite
COMPUTER_USE_MODEL=computer-use-preview
ENABLE_COMPUTER_USE_FALLBACK=false
COMPUTER_USE_MAX_STEPS=8
FRONTEND_ORIGIN=http://localhost:3000

Or set the Gemini key at the Windows user-env level:

setx GEMINI_API_KEY "your_key_here"

Restart the backend after setting it.

SQLite initializes automatically. No Docker or Postgres is needed for local MVP testing.

The backend browser runner uses Node Playwright plus your installed Chrome or Edge:

cd backend
& 'C:\Program Files\nodejs\npm.cmd' install

cd frontend
& 'C:\Program Files\nodejs\npm.cmd' install
& 'C:\Program Files\nodejs\npm.cmd' run dev

Open http://localhost:3000.

Backend:

cd backend
..\.venv\Scripts\python.exe -m pytest tests

Manual API smoke path:

Invoke-RestMethod http://127.0.0.1:8000/health
$run = Invoke-RestMethod -Method Post http://127.0.0.1:8000/api/runs -ContentType 'application/json' -Body '{"url":"https://news.ycombinator.com/","goal":"Understand the first screen.","mode":"USER_TEST"}'
Invoke-RestMethod -Method Post http://127.0.0.1:8000/api/runs/$($run.id)/start -ContentType 'application/json' -Body '{}'
Invoke-RestMethod http://127.0.0.1:8000/api/runs/$($run.id)

Frontend:

cd frontend
& 'C:\Program Files\nodejs\npm.cmd' run build

1. Start backend on http://localhost:8000.
2. Start frontend on http://localhost:3000.
3. Enter a public URL such as https://news.ycombinator.com/.
4. Click Run Browser Review.
5. Watch the run room replay real Playwright screenshots, cursor movement, clicks, scrolls, and narration.
6. Review the evidence timeline, report, and markdown export.

Live URL runs use Playwright sessions first. Gemini is the default planner/synthesis provider through GEMINI_API_KEY. If you explicitly turn ENABLE_COMPUTER_USE_FALLBACK=true, the backend still needs OPENAI_API_KEY because the computer-use fallback is OpenAI-specific. If browser automation fails, the app records honest HTTP evidence instead of seeded demo data.