TinyManus

# 🧠 TinyManus: 一个轻量级的多智能体协作框架 **TinyManus** 是一个最小化、可扩展的多智能体编排框架，旨在支持基于LLM（大语言模型）的任务协作。它提供了干净的智能体抽象、任务级流控制和基于会话的上下文共享，支持用户指定的工作流和自动规划。 --- ## 🚀 特性 - ✅ **简单的智能体接口** 智能体与编排逻辑解耦——只需实现 `run(request: str) -> str`。 - 🧩 **以任务为中心的工作流** 每个任务绑定到一个智能体，并通过 `Session` 级别的流控制器进行管理。 - 🔀 **混合执行计划** 支持混合的顺序和并行执行，如 `[[Task1, Task2], [Task3]]`。 - 🧠 **可选的规划器** 使用 `PlannerAgent` 自动生成任务流，或手动定义以获得完全控制。 - 📝 **带上下文的提示注入** 提示使用带有先前任务历史的模板动态构建。 - 📊 **日志记录与监控** 增强的Emoji日志帮助实时跟踪执行情况。 --- ## 🧪 最小示例 ```python agentA = ReActAgent("AgentA") agentB = ReActAgent("AgentB") agentC = ReActAgent("AgentC") template = TaskPromptTemplate(""" You are a member of a multi-agent collaboration system. Your current task: ---- {task} ---- Previous task history: ---- {history} ---- """) session = Session("TinyDemo", template) session.set_task_flow([ [Task("Introduce TinyManus", agentA), Task("Give a use case", agentB)], [Task("Summarize the above", agentC)] ]) await session.run() ``` --- ## 📁 项目结构 ``` TinyManus/ ├── agent/ # 核心智能体定义 │ ├── base.py # BaseAgent 接口 │ ├── one_shot.py # 一次性智能体变体 │ └── react.py # 基于ReAct的智能体逻辑 ├── memory/ # 内存后端 │ └── memory.py ├── prompt/ # 提示模板 │ ├── react_prompt.py │ └── template.py # 共享提示模板 ├── test/ # （保留用于单元测试） ├── tools/ # 内置工具 │ ├── base.py │ ├── google_search.py │ ├── terminator.py │ ├── tool_collection.py # 工具注册 │ └── cmd/ # 基于Shell的工具 │ ├── shell_tool.py │ └── shell_session.py ├── utils/ │ └── logger.py # 日志工具 ├── workflow/ # 任务/会话编排 │ ├── session.py │ └── task.py ├── llm.py # LLM接口或包装器 ├── main.py # 入口点 ├── LICENSE └── README.md ``` --- ## 🔮 即将推出 - [ ] 任务超时/重试控制 - [ ] 基于DAG（有向无环图）的执行规划 - [ ] 可视化会话仪表板 - [ ] 工具链系统增强 - [ ] MCP（模型上下文协议）支持 - [ ] 多智能体辩论模式与训练数据生成 - [ ] 长期记忆 - [ ] 还有更多... --- ## 🤝 贡献 欢迎提交拉取请求！对于重大更改，请先打开一个问题以讨论您希望更改或改进的内容。 --- ## 🧑‍💻 作者 由 [Zhiyu Zhang](https://github.com/ZhiyuZhangA) 创建，UC Davis。 --- ## 🪄 许可证 Apache 2.0 许可证。有关详细信息，请参见 [LICENSE](./LICENSE)。