Overview
Agentor provides multiple deployment options:- Celesto AI Platform - One-command deployment with observability
- Self-hosted Servers - Deploy with uvicorn, gunicorn, or Docker
- Serverless - Deploy to AWS Lambda, Cloud Run, etc.
- ASGI Servers - Use with any ASGI-compatible platform
Celesto AI Deployment
The fastest way to deploy agents to production.Prerequisites
celesto CLI is automatically installed with Agentor.
Deploy Command
From your project directory:Configuration
Create acelesto.yaml (optional):
Environment Variables
Set required API keys:Observability
Automatic tracing is enabled whenCELESTO_API_KEY is set (src/agentor/core/agent.py:119):
Self-Hosted Deployment
Local Development
Run agents locally (src/agentor/core/agent.py:513):http://localhost:8000.
Production Server
For production, use Gunicorn with uvicorn workers:server.py:
uvicorn Deployment
Run with uvicorn directly:Docker Deployment
Dockerfile
Create aDockerfile:
Build and Run
Docker Compose
Createdocker-compose.yml:
Kubernetes Deployment
Deployment YAML
MCP Server Deployment
Deploy LiteMCP servers (src/agentor/mcp/server.py:14):MCP with Gunicorn
MCP as ASGI App
LiteMCP is a full ASGI application (src/agentor/mcp/server.py:50):Serverless Deployment
AWS Lambda
Use Mangum for Lambda compatibility:Google Cloud Run
Createapp.yaml:
Environment Configuration
Production Settings
Configure for production (src/agentor/config.py):Required Environment Variables
Health Checks
Agents automatically include health endpoints (src/agentor/core/agent.py:573):Monitoring
Logging
Configure logging levels:Tracing
Enable Celesto tracing (src/agentor/tracer.py):Metrics
Integrate with Prometheus:Load Balancing
Nginx Configuration
Security
API Authentication
Implement authentication middleware:HTTPS/TLS
Use a reverse proxy (Nginx, Caddy) or configure uvicorn with SSL:Performance Tuning
Worker Configuration
Optimal workers = (2 × CPU cores) + 1:Concurrency Control
Limit concurrent requests (src/agentor/core/agent.py:393):Troubleshooting
Common Issues
Port already in use:Debug Mode
Enable detailed logging:Next Steps
Agents
Learn about agent configuration
A2A Protocol
Deploy A2A-compatible agents
MCP Servers
Deploy MCP servers
Celesto AI
Deploy to Celesto platform