开始使用

Holon 以可安装的发布形式分发。本节给出从安装到运行 Agent 的最短路径， 并告诉你接下来该往哪里走。

第一次接触 Holon？

如果你是第一次使用 Holon：

• 引导配置 — 通过 holon onboard 交互式完成提供商、凭据、模型和搜索配置
• 创建你的第一个 Agent — 安装、启动、连接 TUI、创建 Agent、配置模型，约 15 分钟

教程涵盖：

• 安装 Holon 并启动运行时
• 用终端 UI（TUI）连接
• 创建 Agent 并发送第一条提示
• 配置模型和提供商

该用哪种运行模式？

Holon 提供三种与运行时交互的方式：

模式	命令	适合场景
单次执行	holon run "..."	快速的单轮任务，不需要 daemon
Daemon + TUI	holon daemon start + holon tui	交互式 Agent 会话，带状态、队列和工作区
Daemon + HTTP	holon daemon start + HTTP 客户端	集成、自动化、控制平面消费方

第一个 Agent 教程使用 daemon + TUI，因为它提供完整的交互体验。 单次执行参见快速示例（英文）。

评估或探索？

如果你已经熟悉 Holon，或想直接深入细节：

• 快速示例（英文）— 单次执行与常见任务模式
• 持久 Agent 工作流（英文）— 持久 Agent 工作的完整生命周期
• 概念 — 深入内部机制前的心智模型
• CLI 参考（英文）— 完整命令面
• 故障排查（英文）— 诊断常见安装问题

贡献或开发？

如果你打算修改 Holon 本身或为其做贡献：

• 本地运行时指南（英文）— 保守的开发工作流
• 文档工作流（英文）— 如何构建和预览本站
• 集成指南（英文）— 把 Holon 接入外部系统
• 仓库 docs/ 目录 — RFC、实现决策和架构笔记

环境要求

• Holon 已安装并在 PATH 上（Homebrew 或直接下载二进制；分步说明见创建第一个 Agent）
• 一个模型提供商 API key（Anthropic、OpenAI 或兼容服务）

仓库导览（贡献者）

这是给贡献者的简短导览。最终用户不需要了解仓库布局。

• src/ 包含 Rust 运行时实现和可执行入口。
• tests/ 包含 Rust 集成测试和共享测试支持。
• docs/ 包含运行时契约、设计记录和当前架构笔记。
• agent_templates/ 包含可远程同步的 Agent 模板。
• docs/website/ 包含本 mdorigin 文档站。

本节页面

• 创建你的第一个 Agent 从零到你的第一个 Holon Agent：安装、启动、TUI 基础、创建 Agent、配置模型。

• 引导配置 用 holon onboard 交互式完成提供商、凭据、模型和搜索配置。