Agent runtime for real systems 面向真实系统的智能体运行时

Controlled autonomy for tool-using agents 面向工具型智能体的受控自主运行时

telos is a Rust runtime boundary for model turns, tool execution, approvals, MCP, plugins, memory, and product clients. telos 是一个 Rust 运行时边界，用来承载模型回合、工具执行、审批、MCP、插件、记忆和产品客户端。

Start building 开始构建 View Rust API 查看 Rust API

Install paths 安装方式

Choose Cargo or PyPI, then run the same telos command. 选择 Cargo 或 PyPI 安装，然后使用同一个 telos 命令启动。

Cargo Cargo cargo install telos-cli Native Rust install 原生 Rust 安装

Python / PyPI Python / PyPI pip install telos-cli Python packaging path Python 包安装路径

Start the CLI 启动 CLI

telos
telos chat

Product surfaces 产品扩展面

One runtime boundary, multiple ways to ship. 一个运行时边界，多种交付方式。

CLI / TUI CLI / TUI

Ship guarded terminal workflows 交付受控终端工作流

Run full-screen sessions, one-shot prompts, approvals, tasks, memory, and provider routing from the same runtime. 用同一个运行时驱动全屏会话、一次性提示、审批、任务、记忆和提供商路由。

Rust library Rust 库

Embed the turn loop 嵌入回合循环

Compose sessions, providers, tools, storage, approvals, and event streams inside your own product. 在自己的产品里组合会话、提供商、工具、存储、审批和事件流。

MCP and plugins MCP 与插件

Extend without runtime rewrites 无需重写运行时即可扩展

Bridge MCP servers and package tools, skills, prompt sections, subagents, and marketplace metadata. 桥接 MCP 服务，并打包工具、技能、提示段、子智能体和市场元数据。

Client direction 客户端方向

One core for many frontends 一个核心，多种前端

Reuse the same Rust runtime behind the CLI, desktop client work, and embedded application flows. CLI、桌面客户端工作和嵌入式应用流程共用同一个 Rust 运行时。

Why telos 为什么是 telos

Built for agents that need to touch real systems. 为需要接触真实系统的智能体构建。

Make side effects inspectable 让副作用可被检查

telos keeps shell commands, file edits, MCP calls, plugin tools, and browser work visible to validation, policy, approval UI, diagnostics, and recovery. telos 让 Shell 命令、文件编辑、MCP 调用、插件工具和浏览器操作都能被验证、策略、审批界面、诊断和恢复流程观察。

Stream the whole turn 流式呈现完整回合

Text, tool requests, tool results, cancellation, compaction, and stop reasons move as structured events instead of hidden client glue. 文本、工具请求、工具结果、取消、压缩和停止原因都以结构化事件流动，而不是藏在客户端胶水代码里。

Keep extension points explicit 保持扩展点明确

Providers, tools, prompt sections, MCP bridges, plugin manifests, skills, memory, and subagents stay behind named interfaces. 提供商、工具、提示段、MCP 桥、插件清单、技能、记忆和子智能体都保留在明确命名的接口之后。

Developer path 开发者路径

Install the client or embed the runtime. 安装客户端，或嵌入运行时。

CLI

cargo install telos-cli
pip install telos-cli

telos
telos chat
telos "inspect this repository"

Library

cargo add telos_agent

let tools = ToolRegistry::default();
let response = session
    .run_turn(&provider, &tools, prompt)
    .await?;

Documentation 文档

Start with workflows, then drop into exact API details. 先从工作流入手，再进入精确 API 细节。

The guides cover installation, CLI usage, configuration, plugins, MCP, deployment, and the Rust library surface. 指南覆盖安装、CLI 使用、配置、插件、MCP、部署，以及 Rust 库接口。

Quick Start 快速开始 Install the CLI, configure a provider, and run your first turn. 安装 CLI、配置提供商，并运行第一个回合。 Library API Guide 库 API 指南 Embed telos_agent and wire your own provider and tools. 嵌入 telos_agent，并接入自己的提供商与工具。 CLI Guide CLI 指南 Use sessions, commands, approval policies, and terminal workflows. 了解会话、命令、审批策略和终端工作流。 Configuration 配置 Layer project, user, provider, model, and approval settings. 管理项目、用户、提供商、模型和审批配置层。 Plugins and MCP 插件与 MCP Connect external tool ecosystems without changing the runtime. 不改运行时即可连接外部工具生态。 Rust API Reference Rust API 参考 Jump into generated rustdoc for exact item-level details. 进入生成的 rustdoc，查看精确到条目的细节。