Quickstart

# Clone the repository
git clone https://github.com/nasirquant/fractal-neural-engine
cd fractal-neural-engine

# Start all services
docker-compose up -d

# Verify the API is running
curl http://localhost:8000/health

# Clone the repository
git clone https://github.com/nasirquant/fractal-neural-engine
cd fractal-neural-engine

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Copy and configure environment
cp .env.example .env
# Edit .env with your API keys

# Start Redis
docker run -d -p 6379:6379 redis:7-alpine

# Run the API server
python main.py

curl -X POST http://localhost:8000/epochs \
  -H "Content-Type: application/json" \
  -d '{
    "num_agents": 10,
    "max_ticks": 100,
    "global_objective": "minimize_loss",
    "convergence_threshold": 0.01
  }'

{
  "epoch_id": "ep_abc123",
  "status": "running",
  "num_agents": 10,
  "max_ticks": 100,
  "global_objective": "minimize_loss",
  "created_at": "2024-01-15T10:30:00Z"
}

# Install websocat for testing
# Then connect to the epoch stream
websocat ws://localhost:8000/epochs/ep_abc123/stream

# Check epoch status
curl http://localhost:8000/epochs/ep_abc123

# Get agent states
curl http://localhost:8000/epochs/ep_abc123/agents

# Get loss history
curl http://localhost:8000/epochs/ep_abc123/loss-history