Skip to main content

Overview

Agentor provides multiple deployment options:
  1. Celesto AI Platform - One-command deployment with observability
  2. Self-hosted Servers - Deploy with uvicorn, gunicorn, or Docker
  3. Serverless - Deploy to AWS Lambda, Cloud Run, etc.
  4. ASGI Servers - Use with any ASGI-compatible platform

Celesto AI Deployment

The fastest way to deploy agents to production.

Prerequisites

The celesto CLI is automatically installed with Agentor.

Deploy Command

From your project directory:
Your agent is deployed to:

Configuration

Create a celesto.yaml (optional):

Environment Variables

Set required API keys:
Find your Celesto API key at: https://celesto.ai/dashboard

Observability

Automatic tracing is enabled when CELESTO_API_KEY is set (src/agentor/core/agent.py:119):
View traces at: https://celesto.ai/observe Disable auto-tracing:

Self-Hosted Deployment

Local Development

Run agents locally (src/agentor/core/agent.py:513):
Access at http://localhost:8000.

Production Server

For production, use Gunicorn with uvicorn workers:
Create server.py:

uvicorn Deployment

Run with uvicorn directly:

Docker Deployment

Dockerfile

Create a Dockerfile:

Build and Run

Docker Compose

Create docker-compose.yml:
Run:

Kubernetes Deployment

Deployment YAML

Deploy:

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

Create app.yaml:
Deploy:

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):
Test:

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:
Module not found:
API key errors:

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
Last modified on May 5, 2026