CleverThis Documentation
CleverThis is a Python-first AI gateway that gives you a unified, OpenAI-compatible interface to every major LLM provider, plus the ability to deploy custom "Actor" endpoints — YAML-configured LLM graphs that appear as first-class models on your API.
Whether you're a developer integrating an AI backend, an ML engineer packaging reusable agent pipelines, or a platform operator running CleverThis on your own infrastructure, this documentation has a guide for you.
Guides
User Guide
Everything you need to start using CleverThis: creating an account, making your first API call, exploring the model library, deploying actors to namespace endpoints, and managing billing.
API Reference
Full reference for the OpenAI-compatible inference API (ct_live_ keys), the management API (ct_mgmt_ keys), Actor endpoint calling, and the A2A control plane at /a2a.
Contributor Guide
Setting up a local development environment, understanding the monorepo layout, running tests with nox, and submitting pull requests.
Sysadmin Guide
Self-hosting CleverThis with Docker Compose or Kubernetes, configuring environment variables, wiring LLM providers, setting up OAuth, and operating the service in production.
Quick Links
| Task | Where to go |
|---|---|
| Create an account | Sign Up |
| Make your first API call | First API Call |
| Browse available models | Models |
| Deploy an Actor | Creating an Actor |
| API authentication | Authentication |
| Chat completions reference | Chat Completions |
| Actor YAML spec | Actor Configuration Standard |
| Self-host with Docker | Docker Compose |