Skip to main content
Deployments are instances of your agent running on Cartesia’s servers.
Deployments

State

Only deployments in the ready state can handle inbound or outbound calls. At any time, only one deployment is active. Deployments that fail health checks will not receive traffic.

Creating a deployment

Use cartesia deploy or push to a linked GitHub repository to create a deployment. Cartesia servers:
  1. Build the virtual environment
  2. Load main.py and instantiate a FastAPI app
  3. Run a health check
  4. Set the deployment to ready and start receiving traffic
Line supports Python 3.9–3.13 (specify in pyproject.toml). FastAPI servers only; more frameworks coming soon.
Pre-Call InitializationInbound calls will ring for five seconds to allow your application logic to warm up any required resources and establish connections.