开始使用
Holon 以可安装的发布形式分发。本节给出从安装到运行 Agent 的最短路径， 并告诉你接下来该往哪里走。
最短路径
brew tap holon-run/tap && brew install holon
holon onboard
holon daemon start
打开 http://localhost:7878，或运行 holon tui。第一次使用成功意味着你能够：
- 向默认 main agent 发送一项有明确边界的请求；
- 看到 Agent 检查真实工作区或运行已获允许的工具；
- 收到精炼结果，或一项明确的下一步决策请求。
下方教程提供完整的分步说明，涵盖提供商配置、安装、连接 TUI 和创建第一个 Agent。
第一条持续工作流可以选择一项天然需要等待的职责：跟进 PR 与 CI、等待证据的问题分析， 或保留明确人工审批点的发布协调。
该用哪种运行模式？
Holon 提供三种与运行时交互的方式：
| 模式 | 命令 | 适合场景 |
|---|---|---|
| 单次执行 | holon run "..." | 快速的单轮任务，不需要 daemon |
| Daemon + TUI | holon daemon start + holon tui | 交互式 Agent 会话，带状态、队列和工作区 |
| Daemon + HTTP | holon daemon start + HTTP 客户端 | 集成、自动化、控制平面消费方 |
第一个 Agent 教程使用 daemon + TUI，因为它提供完整的交互体验。 单次执行参见快速示例。
评估或探索？
如果你已经熟悉 Holon，或想直接深入细节：
- 运行你的第一个 Holon 任务 — 单次执行与常见任务模式
- 运行长生命周期任务 — 会等待、能断线恢复并交付的工作
- 委派工作给另一个 Agent — 把边界清楚的任务交给子 Agent
- 通过 HTTP 自动化 Holon — 用代码驱动 Holon
- 概念 — 深入内部机制前的心智模型
- CLI 参考 — 完整命令面
- 排查 Holon 任务问题 — 诊断常见安装与运行问题
贡献或开发？
如果你打算修改 Holon 本身或为其做贡献：
- 本地运行 Holon — 保守的开发工作流
- 文档工作流 — 如何构建和预览本站
- 仓库
docs/目录 — RFC、实现决策和架构笔记
环境要求
- Holon 已安装并在
PATH上（Homebrew 或直接下载二进制；分步说明见下方教程） - 一个模型提供商 API key（Anthropic、OpenAI 或兼容服务）
社区交流与反馈
- 加入 Holon Pioneers Google Group 交流使用心得、探讨工作流配方并参与新版本测试；
- 关注 X 官方账号 @holonrun 获取产品发版与特性动态；
- 在 GitHub Issues 反馈缺陷与提出功能建议。
寻找内核贡献者规格？
如果你正在参与 Holon 运行时内核开发或需要查看内部状态机契约，请参阅面向维护者的 运行时规格 与仓库开发指南。