项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- Python 环境(README 未注明具体版本,以 setup.py 检查结果为准)
- Poetry(启动命令为 poetry run world,需自行准备)
- OpenAI API Key(用于 GPT-4 调用)
- 能够访问 OpenAI API 的网络环境
安装与启动步骤
-
1克隆仓库
把 GPTeam 源码拉到本地任意目录,然后进入项目文件夹准备后续配置。
git clone https://github.com/101dotxyz/GPTeam.git -
2进入项目目录
切换到刚克隆下来的仓库目录,后续命令都在这个目录里执行。
cd gpteam -
3检查环境
运行 setup.py 检查本机环境是否满足要求,并按提示完成必要配置。
python setup.py -
4配置 API Key
在仓库的 .env 文件中填入你的 API Key,至少需要 OpenAI 的 key;填入可选服务 key 可解锁更多工具。
-
5启动世界
用 poetry 启动多智能体模拟世界,随后即可观察智能体之间互相协作、对话与行动。
poetry run world -
6低成本模式(可选)
加上 --turbo 参数后所有 LLM 调用改用 gpt-3.5-turbo,花钱更少但结果质量会下降。
poetry run world --turbo
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPENAI_API_KEY | 是 | 在 .env 中填入 OpenAI API Key;README 未写明确切变量名,以仓库 .env 模板为准 | sk-xxxxxxxx |
可选服务 API Key | 否 | 填入其他服务的密钥可启用对应的额外工具,不填则仅使用基础能力 | 见仓库 .env 模板 |
如何确认成功
终端能看到世界运行日志,智能体之间开始互相交流并执行各自的任务指令,说明启动成功。
常见问题
Q:没有 OpenAI API Key 能跑吗?
A:不能。README 明确要求提供 OpenAI API Key,可在 https://platform.openai.com/account/api-keys 获取后写入 .env。
Q:想省钱怎么运行?
A:使用 poetry run world --turbo,所有 LLM 调用改用 gpt-3.5-turbo,费用低很多,但效果会变差。
Q:python setup.py 是安装脚本吗?
A:README 说明它用于检查你的环境配置并按需调整,运行后请根据提示完成后续配置。
Q:为什么启动命令带 poetry?
A:README 给出的启动方式就是 poetry run world,说明项目用 Poetry 管理依赖,需先自行安装 Poetry。
注意事项
- README 未提供 Poetry 的安装步骤,需自行准备 Poetry 环境后再执行启动命令。
- 默认使用 GPT-4,调用成本较高,建议先用 --turbo 模式试跑。
- .env 中的具体变量名和可选服务列表请以仓库内实际模板为准,README 未逐项列出。
- 项目受 AutoGPT 类自主智能体启发,运行过程为非脚本化结果,首次体验建议观察日志输出。
核心亮点
- 基于 GPT-4 驱动,智能体具备自主对话、记忆和工具调用能力,模拟真实团队互动
- 提供可配置的角色、目标和环境,支持快速搭建自定义多智能体场景
- 开源 Python 实现,便于研究者修改和扩展智能体行为逻辑
不足之处
- 依赖 OpenAI API,运行成本较高且需要网络连接
- 项目文档和示例相对有限,新手上手需要一定调试成本
适用场景
- 研究多智能体协作与涌现行为的学术实验
- 快速生成互动式故事或游戏剧情原型
- 模拟虚拟团队完成复杂任务,如项目分工与决策
替代项目
AutoGen、CrewAI
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
geo-sleuth
开源
给 AI 装上地理侦探技能,一张照片顺藤摸瓜找到拍摄地
An agent skill that finds where a photo was taken — OpenStreetMap geometry, elevati···
goutoujunshi
开源
先哄情绪再出招,恋爱难题给可执行方案
一个先接住情绪、再分析关系并给出可执行策略的 Codex 恋爱军师,内置心理、法律、社会、人···
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
