Quickstart

Get Purple8 Builder running and complete your first build in under 10 minutes.

Prerequisites

• Docker 24+ and Docker Compose v2
• 8 GB RAM minimum (16 GB recommended)
• At least one LLM API key (OpenAI, Anthropic, or Google)

1. Clone the repository

git clone https://github.com/Redlock666/Purple8-platform.git
cd Purple8-platform

2. Configure environment

cp config/dev.env.template .env

Open .env and set these required values:

# Database
POSTGRES_PASSWORD=your_password_here

# Security — generate with: openssl rand -hex 32
JWT_SECRET=your_32_char_secret_here

# Message broker
RABBITMQ_DEFAULT_PASS=your_password_here

# Object storage
MINIO_ROOT_PASSWORD=your_password_here

# LLM — at least one required
OPENAI_API_KEY=sk-...
# ANTHROPIC_API_KEY=sk-ant-...
# GOOGLE_API_KEY=AIza...

Local models (free)

Add OLLAMA_BASE_URL=http://localhost:11434 to use Ollama instead of a cloud provider. Builder will route simple tasks to local models automatically.

3. Start the platform

docker compose up -d

First run pulls images and builds local services — allow 5–10 minutes.

4. Verify everything is running

docker compose ps

You should see 14 containers all showing Up or Up (healthy).

Service	URL
Frontend	http://localhost:8080
API Gateway + Swagger	http://localhost:8081/docs
RabbitMQ UI	http://localhost:15672
MinIO Console	http://localhost:9001

5. Your first build

1. Open http://localhost:8080
2. Sign in (default credentials in your .env)
3. Click New Build
4. Type your prompt:

Build a REST API with FastAPI and PostgreSQL.
Include endpoints for users and products with full CRUD.
Add JWT authentication and a pytest test suite.

5. Select goal: Prototype
6. Click Build — watch the agents work in real time via the SSE stream

Your project will be ready in the generated_projects/ directory in 3–8 minutes.

Next steps

• Your First Build — deeper walkthrough
• Docker Setup — production docker configuration
• Architecture — how it works under the hood