Getting Started

Prerequisites

• Docker Desktop (with Compose V2)
• VS Code with the Dev Containers extension
• API keys (optional): Anthropic, DeepSeek, Google AI

Installation

git clone https://github.com/p31labs/p31.git
cd p31
cp .env.example .env
# Edit .env with your API keys
just setup
just dev

Open in VS Code

1. Open the p31 folder in VS Code
2. Click “Reopen in Container” when prompted
3. Wait for the devcontainer to build
4. All services start automatically

Verify

curl localhost:8031/health        # Backend
curl localhost:7474               # Neo4j Browser
curl localhost:4000/health        # LiteLLM

Services

Service	Port	Command
Frontend (Vite)	3031	just frontend
Backend (FastAPI)	8031	just backend
Neo4j	7474 / 7687	just dev
LiteLLM	4000	just dev (ai profile)
Ollama	11434	just dev (ai profile)
Docs (Astro)	4321	just docs