Development
Set up your local development environment and learn how to test AxonFlow.
Development Guides
| Guide | Description |
|---|---|
| Local Development | Set up AxonFlow locally with Docker Compose |
| Testing Overview | Testing strategies and best practices |
| Load Testing | Performance and load testing methodology |
| Performance Testing | Benchmark and optimize your deployment |
Quick Start
Prerequisites
- Docker and Docker Compose
- Go 1.21+ (for building from source)
- Node.js 18+ (for frontend development)
Local Setup
# Clone the repository
git clone https://github.com/getaxonflow/axonflow.git
cd axonflow
# Start all services
docker compose up -d
# Verify services are healthy
docker compose ps
Service Endpoints
| Service | URL | Description |
|---|---|---|
| Agent | http://localhost:8080 | Policy enforcement |
| Orchestrator | http://localhost:8081 | Multi-agent planning |
| Prometheus | http://localhost:9090 | Metrics |
| Grafana | http://localhost:3000 | Dashboards |
Testing
Unit Tests
# Run all tests
go test ./platform/...
# Run with coverage
go test ./platform/... -cover
# Run specific package
go test ./platform/agent/...
Integration Tests
# Start test environment
docker compose -f docker-compose.test.yml up -d
# Run integration tests
go test ./platform/... -tags=integration
Project Structure
axonflow/
├── platform/
│ ├── agent/ # Policy enforcement agent
│ ├── orchestrator/ # Multi-agent planning
│ ├── connectors/ # MCP connectors
│ └── shared/ # Shared libraries
├── docs/ # Documentation
├── deploy/ # Deployment configs
└── docker-compose.yml # Local development
Next Steps
- Set up Local Development environment
- Review the Testing Overview
- Run Load Testing to benchmark performance
- See Contributing to contribute back