Requirements

CodePilot requires several runtime dependencies and services to operate. This page lists all requirements for both development and production environments.

System Requirements

Runtime Dependencies

Node.js

Node.js 20 or later is required. We recommend using a version manager:

nvm install 20
nvm use 20

fnm install 20
fnm use 20

volta install node@20

pnpm

pnpm 10 or later is required for workspace management:

corepack enable
corepack prepare pnpm@latest --activate

Docker & Docker Compose

Docker is used to run PostgreSQL and Redis in development, and all services in production.

• Docker Desktop (macOS / Windows)
• Docker Engine (Linux)

Verify the installation:

docker --version
docker compose version

Ollama

Ollama runs AI models locally. Install it from ollama.ai/download.

After installation, pull the required models:

ollama pull nomic-embed-text    # Embeddings (required)
ollama pull qwen2.5-coder:3b    # Chat & code review (required)
ollama pull qwen2.5:7b           # Repository intelligence (optional)

GitHub App

For GitHub OAuth and webhook integration, you need a GitHub App. See Authentication for setup instructions.

Services

CodePilot depends on the following services, all of which are provided via Docker Compose:

Network Ports

Ensure these ports are available on your machine: