这是一个Alpha版本的框架，可用于概念验证，并非生产就绪，可能有大量的破坏性更新
通用分布式智能体集群框架
可以用于构建安全的，可审计的，为各种任务负载，从单智能体到智能体集群系统的运行时核心
uv sync使用Agentconf的TUI配置你的LLM供应商、模型、Agent
uv run agentconfuv run python examples/simple_chat.py或者运行examples下的其他示例
src/ghrah/
├── core/ # 核心抽象：配置、消息、事件、异常、HITL、CommandSender
├── agents/ # Agent 实现：ActorAgent 基类
├── chat/ # LLM 交互层：ChatMessage、ContentBlock、ChatFormat
│ └── format/ # 格式适配器：OpenAIFormat、AnthropicFormat
├── abilities/ # 能力系统：Ability 接口、Hook、执行器、内置 Ability
│ └── builtin/ # 内置 Ability：对话、文件操作、任务终止、集群操作等
├── context/ # 上下文管理：ActionChain、StateManager、MessageStore、窗口策略
│ └── persistence/# 持久化后端：JSON、SQLite、内存、远程
├── llm/ # LLM 集成：LLMFactory（agentconf → ChatFormat）
└── communication/ # 通信层：Router、Registry、Supervisor
完整使用说明文档见 docs/ 目录：
| 文档 | 中文 | English |
|---|---|---|
| 安装与快速开始 | getting-started.md | getting-started_en.md |
| 核心概念 | core-concepts.md | core-concepts_en.md |
| Ability 系统 | ability-system.md | ability-system_en.md |
| Hook 机制 | hook-mechanism.md | hook-mechanism_en.md |
| 上下文管理 | context-management.md | context-management_en.md |
| 多 Agent 通信 | multi-agent.md | multi-agent_en.md |
| 持久化与窗口管理 | persistence.md | persistence_en.md |
| 内置 Ability 参考 | builtin-abilities.md | builtin-abilities_en.md |
| 配置参考 | configuration.md | configuration_en.md |
| 异常处理 | error-handling.md | error-handling_en.md |
| 架构图与流程图 | architecture.md | architecture_en.md |
| Chat 交互层 | chat-module.md | chat-module_en.md |
| 双模式架构 | distributed-mode.md | distributed-mode_en.md |
| HITL 人在回路 | hitl.md | hitl_en.md |
# 安装开发依赖
uv sync --extra dev
# 运行测试
uv run pytest tests/ -v
# 代码检查
uv run ruff check src/ tests/Apache 2.0