everruns/everruns

**Build capable AI agents in Rust. Run them where they belong.**
Everruns is an open-source framework for building AI agents directly in Rust
applications. Define agents, attach models and typed tools, run multi-turn
sessions, and observe execution through one application-facing API.
Use the framework in your application. When you need a shared runtime and
production operations, run the Everruns platform yourself or use
Everruns Cloud.
Build with the framework · Read the docs · Use Everruns Cloud
Build an agent
Add the application-facing crate:
Then define a typed tool, give it to an agent, and run a turn:
Everruns derives the tool schema from the Rust function, lets the model call it during the turn, and returns the result before producing the final response. Continue the framework quickstart.
> **Note:** Everruns is under active development. Expect rapid changes and experimental features.
The agent framework
The everruns crate keeps the application-facing agent
loop explicit and embeddable:
- **Agents and sessions** — describe an agent once, then create independent,
multi-turn conversations through an Engine.
- **Models and providers** — start offline, use OpenAI, or attach a custom
provider without coupling application code to a closed provider enum.
- **Typed tools and capabilities** — give agents function tools and opt into
filesystem, shell, web, Lua, and MCP boundaries deliberately.
- **Events, cancellation, and lifecycle hooks** — observe a live turn, add
application behavior at execution boundaries, and stop work cooperatively.
- **Persistence and execution choices** — begin with engine-lifetime memory,
add local crash-durable state, or cross deliberately into a distributed host.
Framework overview
Choose how you run Everruns
| Framework | Self-hosted platform | Everruns Cloud |
| --- | --- | --- |
| Start here. Embed Everruns in the Rust application you are building; you own the process, deployment, integrations, and data path. Framework quickstart → | Run the shared runtime in infrastructure you manage when you need a control plane, server, workers, UI, remote API, and durable execution. Docker Compose quickstart → · Architecture → | Use the shared runtime and production operations without operating the platform yourself. Everruns Cloud quickstart → · Open app.everruns.com → |
Platform capabilities
The Platform, self-hosted or on Everruns Cloud, adds durable execution, a stateless worker
pool, a web UI, and a remote API. It also publishes agents to Slack, web chat,
A2A, webhooks, schedules, voice, HTTP, and MCP; manages organizations and
permissions; and supports observation, budgeting, and evaluation.
Platform capabilities · Channels · Durable execution · Observability
Documentation
Full documentation lives at **everruns.com/docs**.
- Everruns Framework — build and run agents inside a Rust application