Quick Start

Prerequisites

• Node.js 22+ — Required for all native services
• npm 10+ — Comes with Node.js 22
• Git — For cloning repositories and workspace management
• Docker & Docker Compose (optional) — For containerized deployment

Option 1: Native Installation

Clone the repository and install dependencies:

git clone https://github.com/anastawfik/condrix.git
cd condrix
npm install

Build all packages:

npm run build

Start the Core daemon:

npm run dev:core

In a separate terminal, start the Web Client:

npm run dev:web

Open your browser to http://localhost:5173. You should see the Condrix web interface. The Core will be listed in the sidebar — click it to connect.

Authenticate with Claude

Before you can start an AI agent session, the Core needs to authenticate with Claude:

1. Open Settings (gear icon) in the web client
2. Navigate to the Cores tab
3. Click Sign In with Claude on your Core
4. A browser window opens — sign in with your Claude account
5. Paste the authorization code back into the dialog
6. The Core is now authenticated and ready to create agent sessions

Option 2: Docker Compose

Create a docker-compose.yml file:

services:
  maestro:
    image: ghcr.io/anastawfik/condrix-maestro:latest
    ports:
      - "9200:9200"
    volumes:
      - maestro-data:/data
    environment:
      - CONDRIX_MAESTRO_PORT=9200

  core:
    image: ghcr.io/anastawfik/condrix-core:latest
    ports:
      - "9100:9100"
    volumes:
      - core-data:/data
      - claude-data:/root/.claude
    environment:
      - CONDRIX_CORE_PORT=9100
      - CONDRIX_CORE_HOST=0.0.0.0
      - CONDRIX_MAESTRO_URL=ws://maestro:9200

  web:
    image: ghcr.io/anastawfik/condrix-web:latest
    ports:
      - "5173:80"

volumes:
  maestro-data:
  core-data:
  claude-data:

Start all services:

docker compose up -d

Open http://localhost:5173 in your browser.

Default Ports

Service	Port	Description
Core	9100	Agent runtime daemon (WebSocket)
Maestro	9200	Orchestration service (WebSocket)
Web Client	5173	Browser-based UI (HTTP)
Docs	5174	Documentation site (HTTP)

What’s Next?

• Authentication — Learn about OAuth and API key setup
• Architecture Overview — Understand how the pieces fit together
• Environment Variables — Configure ports, hosts, and features