Skip to main content
Fleet is delivered as a backend service plus a terminal client. The maintained public surface is the HTTP + SSE API and the CLI. This page documents the small Python surface exposed for embedding and scripting. There is no maintained public runtime library. Modules under src/fleet_rlm/ (api, chat, rlm, daytona, sessions, persistence, composition) are internal ownership boundaries and change without notice. When the docs disagree with the code, trust the code.

Application factory

Fleet exposes one FastAPI factory. The default composition inventory comes from the profile selected in config/fleet.toml.
create_app():
  • Builds the FastAPI application.
  • Installs handlers and routers.
  • Eagerly constructs the immutable bundled Skill catalog.
FastAPI lifespan validates settings and installs one complete Daytona (or explicitly injected private-test) runtime inventory. Lifespan owns startup rollback and shutdown.

Console-script entry points

These are the packaged commands. Each is thin glue over Click or the FastAPI factory. See the CLI reference for their flags and semantics.

Programmatic backend startup

To embed the backend inside another Python process, call the FastAPI factory and hand it to your ASGI server. Loopback binding stays enforced through the CLI layer; when embedding, enforce network exposure at your ASGI server or reverse proxy.
The lifespan probe still requires config/fleet.toml with an explicit [config] default_profile and every environment variable referenced by that profile. The database must already be at the Alembic head; startup does not run migrations.

Sandbox-serializable inputs

dspy.RLM receives large inputs through DSPy’s own SandboxSerializable contract (DSPy 3.3.0b1). Fleet-owned host code builds these values on the Fleet Root’s behalf. They are host-constructed under strict local validation and are not part of a public Python-integration surface. Custom Skill Signatures see only JSON-compatible common input fields. If you are authoring a Skill, define your Signature against the shipped common input contract; do not import Fleet-internal capsule classes.

Import verification

Verify the small maintained entry points import cleanly against the installed distribution:

See also

  • HTTP API for the maintained public contract.
  • CLI for the packaged commands.
  • Configuration for config/fleet.toml and the environment inputs each profile requires.
Last modified on August 13, 2026