Ethos - AI agent runtime
An actively developed Python runtime connecting language models to tools through a CLI and authenticated REST API.
details for Ethos - AI agent runtime
Ethos is a Python runtime I’m developing to provide a shared foundation for AI agents. It brings model integration, persistent sessions, tools, and configurable personas together around workspace-scoped context. The runtime connects to OpenAI, Google, and Ollama models, with a command-line interface and an authenticated REST API built on FastAPI.
The architecture separates agent execution and application state from the interfaces that use them. Both the CLI and API operate through the same service layer, while capabilities contribute tools and instructions through a common interface. This keeps behaviour consistent and allows the runtime to grow without coupling its core logic to individual clients or tools.
A central focus is controlled, recoverable execution. Agents can inspect project files, request approval for changes, and run approved commands within a native sandbox. Durable approval records and explicit recovery for interrupted actions help prevent accidental replay, making permissions and failure handling part of the runtime itself.
Ethos also includes an evaluation harness that exercises models against task-completion and security scenarios using the real agent runtime. Reports track pass rates, tool usage, latency, and token consumption to support evidence-based model comparisons. The project is currently in alpha, with ongoing work on the core runtime and a longer-term direction towards workflows and orchestration.