Skip to content

Latest commit

 

History

History
135 lines (101 loc) · 2.58 KB

QUICK-START.md

File metadata and controls

135 lines (101 loc) · 2.58 KB

Cortex Quick Start

Get Cortex running in 10 minutes.

Prerequisites

  • macOS or Linux
  • Node.js 18+
  • Python 3.8+
  • Git
  • API keys (Anthropic Claude)

1. Install Dependencies

# Install Node dependencies for dashboard
cd api-server
npm install
cd ..

# Install Python dependencies (optional, for ML features)
cd python-sdk
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cd ..

2. Configure Environment

# Copy example config
cp .env.example .env

# Edit .env and add your API keys
nano .env

# Required:
ANTHROPIC_API_KEY=your-key-here
API_KEY=your-dashboard-api-key

# Optional:
SEMANTIC_ROUTING_ENABLED=false  # Disable ML features for simplicity
PYTORCH_ROUTING_ENABLED=false

3. Start the Dashboard

# Start API server
cd api-server
npm start

# Dashboard runs at: http://localhost:9000
# Note: Port changed from 5001/3000 to 9000 to avoid conflicts

4. Run Your First Task

Create a simple test task:

# The system should be watching the task queue
# Add a task to coordination/task-queue.json or use the API

curl -X POST http://localhost:9000/api/tasks \
  -H "x-api-key: your-dashboard-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "test-001",
    "type": "development",
    "description": "Create a simple hello world script at scripts/hello.sh",
    "priority": "medium"
  }'

5. Monitor Progress

Open http://localhost:9000 in your browser to see:

  • Task queue status
  • Worker pool
  • System health
  • Routing decisions

What's Next?

Troubleshooting

Dashboard won't start

# Check if port 9000 is in use
lsof -i :9000

# Kill if needed
kill -9 <PID>

# See PORT-POLICY.md for port assignment rules

Workers not spawning

# Check worker daemon
./scripts/daemon-control.sh status

# Restart if needed
./scripts/daemon-control.sh restart

Token budget errors

# Check budget
cat coordination/token-budget.json | jq

# Reset if needed (WARNING: This will reset usage tracking)
echo '{"budget":{"daily":{"limit":270000,"used":0}}}' > coordination/token-budget.json

Minimal Configuration

For the simplest setup (no ML features):

# .env
ANTHROPIC_API_KEY=your-key
API_KEY=your-dashboard-key
SEMANTIC_ROUTING_ENABLED=false
PYTORCH_ROUTING_ENABLED=false
RAG_ENABLED=false

This gives you basic keyword routing without ML overhead.