Prerequisites

porto is two long-running services plus a local Postgres. The pins below are what CI runs.

Tool	Pin	Why
Node.js	20 or 22 (`frontend/.nvmrc` is `22`)	Next 15 supports even LTS only. Odd majors (21, 23, 25) break `next start`.
Python	3.11 (`backend/.python-version`)	Backend venv and tests.
npm	whatever ships with that Node	Frontend install. Not pnpm.
Docker	Desktop or daemon running	Local Supabase stack.
Supabase CLI	2.0.0 or newer	`supabase start` / migrations.

Confirm on your machine:

./scripts/check-versions.sh

A green check means your toolchain matches CI.

Optional, for CLI seats

Only needed if you will use those providers:

Harness	Install	Login
Claude Code	Anthropic’s Claude Code CLI	`claude /login`
Codex	OpenAI Codex CLI	`codex login`
Grok	xAI Grok CLI	`grok auth login`
Mistral Vibe	`brew install mistral-vibe`	Same Mistral API key as the Mistral card

Ollama if you want the Ollama provider
Any OpenAI-compatible server (vLLM, LM Studio, llama.cpp, a Tailscale box) if you want Local / network