PraisonAI
用 Python、JS、CLI 和 YAML 构建可编排的多智能体工作流。
- Star 数
- ★ 9.3k
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 42/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- Python 开发者需要让研究员与写作者两个角色顺序协作时，可用
Agents组合多个Agent并启动团队。 - 不适合
- 希望开箱即用、无需自行配置模型密钥与渠道令牌的用户
- 需要官方提供生产部署拓扑与兼容性矩阵的企业运维团队
这个 Agent 能做什么，适合哪些场景？
PraisonAI 是一个面向 AI 智能体开发的 SDK、CLI 与可视化组件集合。核心 Python 包 praisonaiagents 提供 Agent、Agents 和 MCP 接口，可运行单智能体或多智能体任务。仓库同时提供 praisonai CLI、YAML 配置执行方式，以及 Claw Dashboard、Langflow Flow Builder 和聊天 UI 等可选界面。它文档化了规划、工作流路由、并行与循环、记忆、RAG、守卫规则、会话持久化和 MCP 工具连接等能力。任务可以通过 Python、JavaScript、命令行或 YAML 启动，结果由相应的智能体或工作流执行路径返回；Dashboard 默认在本地 8082 端口提供管理页面。
开发者创建 Agent(instructions=...) 后用 agent.start(...) 执行自然语言任务，或把多个 Agent 放入 Agents(agents=[...]) 后调用 agents.start()。智能体可挂载 Python @tool 函数，调用 MCP 服务器；README 展示了 stdio、HTTP 和 WebSocket 形式的 MCP 连接。工作流支持 route()、parallel()、loop() 与 repeat() 等模式，并可使用记忆、知识/RAG、会话和数据库持久化。CLI 可运行 YAML 定义的团队、管理 memory、knowledge、session 和 MCP 配置，并提供 research、workflow、schedule 等命令。可选的 praisonai claw 启动本地 Dashboard，praisonai flow 启动 Langflow 可视化流程界面。
- Python 开发者需要让研究员与写作者两个角色顺序协作时，可用
Agents组合多个Agent并启动团队。 - 需要将内部或第三方 MCP 服务接入任务流的团队，可通过
MCP("npx ...")、HTTP 或 WebSocket 配置工具。 - 希望把无代码任务定义提交到版本库的运营人员，可编写
agents.yaml并执行praisonai agents.yaml。 - 需要把会话、运行记录和追踪信息持久化到数据库的应用，可为
Agent配置db(database_url=...)和session_id。 - 需要在 Telegram、Discord、Slack 或 WhatsApp 等渠道集中管理智能体的团队，可安装 Claw 扩展并运行本地 Dashboard。
- 希望以拖放方式组合顺序或并行团队的用户，可通过 Langflow 的 Agent 与 Agent Team 组件构建流程。
如何安装或部署这个 Agent？
需要可运行 pip 的 Python 环境和可访问所选模型服务的网络连接。安装核心 SDK 并设置 OpenAI 凭据：
pip install praisonaiagents
export OPENAI_API_KEY="your-api-key"然后创建 Python 文件，使用 from praisonaiagents import Agent。如需完整 CLI：pip install praisonai。JavaScript SDK 的安装命令为：npm install praisonai。
如何使用这个 Agent？
最小 Python 调用：
from praisonaiagents import Agent
agent = Agent(instructions="You are a senior data analyst.")
agent.start("Analyze the top 3 tech trends of 2026 and format as a markdown table.")YAML 模式中，将 framework: praisonai、topic 和 agents 写入 agents.yaml，再运行：praisonai agents.yaml。启用 Claw Dashboard 时安装 pip install "praisonai[claw]"，配置 OPENAI_API_KEY；其内置网页搜索还需要 TAVILY_API_KEY，然后运行 praisonai claw 并访问 http://localhost:8082。
这个 Agent 有哪些优点和局限？
- 核心 API 很小：
Agent、Agents和MCP即可覆盖单智能体、团队与 MCP 工具接入。 - 同一仓库提供 Python、JavaScript、CLI、YAML、Dashboard 和 Langflow 流程构建器，适合不同交付入口。
- README 明确列出 MCP 的 stdio、HTTP、WebSocket 和 SSE 传输方式，并给出连接示例。
- 工作流能力覆盖路由、并行、循环、重复评估、条件分支与检查点等具体编排模式。
- 支持多种模型提供方，并包含 OpenAI、Anthropic、Gemini、Ollama 等提供方示例。
- 首次 Python 示例要求配置
OPENAI_API_KEY；不同模型提供方还需要各自的凭据与服务可用性。 - Claw 的内置网页搜索额外要求
TAVILY_API_KEY，渠道接入还涉及平台令牌配置。 - MCP 的本地示例依赖
npx，使用这些服务器时需要相应的 Node.js/包执行环境。 - README 列出大量功能，但本资料未给出各可选组件的版本兼容矩阵、资源需求或生产部署拓扑。
- 自定义工具若处理模型或用户输入，必须自行验证和清理输入；README 明确警告不要使用
eval()、exec()或subprocess。
这个 Agent 与同类方案有什么区别？
PraisonAI 文档将 Claude Code、Gemini CLI 与 Codex 列为可编排的外部智能体；其定位是通过自身的 Agent、工作流和工具接口协调这些外部工具，而非替代它们的命令行产品。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| PraisonAI 当前 | 42 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 9.3k | 1 天前 | Python | Codex · Claude Code · OpenAI API · Claude API |
| Youtu-Agent | 27 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 4.6k | 1 天前 | Python | OpenAI API |
| MCP Memory Service | 68 · 存在缺口 | MCP 服务器免费 | ★ 2.1k | 1 天前 | Python | ChatGPT · Codex · Claude Code · Claude.ai |
| Microsoft Agent Framework 实战示例 | 50 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 390 | 5 个月前 | Jupyter Notebook | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 强调安全注意事项（避免 eval/exec），SECURITY.md 提供漏洞报告流程，但未提供权限最小化或用户确认机制。数据流透明度不足，敏感数据处理仅提及环境变量。依赖安全有安全策略但无具体审计。外部影响包括安装脚本和 MCP 工具，但未明确限制。回滚功能有 shadow git checkpoints 提及。来源归属有 MIT 许可证和作者信息。扣分原因：缺乏用户确认、数据流透明度、敏感数据处理的详细说明。
证据显示：README 和文档结构一致，提供多种使用场景和示例。依赖可用性未明确说明，但提及支持多种 LLM 提供商。失败消息未详细描述。扣分原因：依赖可用性和失败消息缺乏具体证据。
证据显示：README 明确目标受众（开发者）和多种使用场景（研究、代码生成等）。能力边界未明确，但提供功能列表。触发精度未详细说明。环境适配支持多种 LLM 和部署方式。扣分原因：能力边界和触发精度缺乏明确说明。
证据显示：README 结构清晰，提供安装说明（pip/npm/curl），命名稳定（praisonaiagents 等），有大量示例和文档链接。已知限制未明确列出。许可证为 MIT。版本和变更日志未提供。维护责任有 SECURITY.md 和贡献指南。扣分原因：已知限制、版本和变更日志缺失。
证据显示：输出可用性通过示例和文档体现，边际价值高（多智能体、MCP 等），成本效益未明确说明。扣分原因：成本效益缺乏具体数据。
证据显示：README 中的声明有文档链接支持，但未提供独立验证。跨来源佐证有限。事实与推断未明确区分。扣分原因：缺乏独立验证和事实推断分离。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 安装脚本（curl | bash）存在供应链风险，建议审查脚本内容。
- MCP 工具和外部代理可能执行任意代码，需谨慎配置权限。
- 环境变量（如 API 密钥）处理需确保安全存储，避免泄露。
你是这个项目的维护者？把 FARS 徽章加到 README
[](https://followagents.com/zh/agents/praisonai)<a href="https://followagents.com/zh/agents/praisonai"><img src="https://followagents.com/badge/praisonai.svg?lang=zh" alt="FARS 评测"></a>最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
常见问题
最小运行需要什么凭据？
OPENAI_API_KEY。若使用 Claw 的内置网页搜索，还需要 TAVILY_API_KEY。能否不写 Python？
praisonai CLI，以及可由 praisonai agents.yaml 执行的 YAML 定义。它能接入现有工具服务器吗？
MCP 接入；README 展示了 stdio、本地 npx、HTTP、WebSocket 与带环境变量的配置方式。是否能保存会话和记忆？
memory=True 启用文件型记忆；配置 db(database_url=...) 和 session_id 可持久化消息、运行和追踪信息。