MervinPraison/PraisonAI

PraisonAI 🦞 — Hire a 24/7 AI Workforce. Stop writing boilerplate and start shipping autonomous self-improving agents that research, plan, code, and execute tasks. Deployed in 5 lines of code with built-in memory, RAG, and support for 100+ LLMs.

📚 快速摘要

PraisonAI 是一个以 Python 为主的框架，用于构建能够规划、行动并自我改进的 自主 AI 代理。它提供分层的“五层代理堆叠”（Prompt → Context → Harness → Loop → Graph）以及“托管代理”层，让您可以在 Docker、e2b、Modal 等远程沙盒中执行繁重任务（工具执行，甚至整个代理）。该项目包含：

核心 SDK (praisonaiagents) 用于代码优先开发。
CLI (praisonai) 和可选的 UI/仪表板扩展功能。
JavaScript SDK。
支持 100 多个 LLM 提供者。
用于研究、编码、内容、数据管道、支持机器人和工作流程自动化的示例代理。

🛠️ 核心组件

组件	功能	使用方式
Agent	具有记忆、工具和防护栏的单一 LLM 驱动工作者。	`Agent(role="Senior Data Analyst").start("Analyze trends")`
AgentFlow	多代理的图形化编排（路由、并行、重复）。	`AgentFlow(steps=[classifier, route(...), parallel([...])])`
ExecutionConfig	控制循环限制、预算和死循环检测。	`execution=ExecutionConfig(max_iter=30, max_budget=0.5)`
Managed Runtime	在远程沙盒（Docker、e2b、Modal 等）中执行工具或整个代理。	`tools_run_on="docker"` 或 `run_on="anthropic"`
MCP Protocol	通过 stdio、HTTP、WebSocket、SSE 公开工具的统一方式。	`tools=[MCP("npx ...")]`
CLI	管理沙盒、列出会话、从终端启动代理。	`praisonai managed ps`

🚀 入门指南 (Python)

pip install praisonaiagents   # 核心 SDK
export OPENAI_API_KEY=…

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 markdown")

远程执行示例：

agent = Agent(name="builder", instructions="You build things.", tools_run_on="docker")
agent.start("Write a script that prints primes, then run it")

📦 生态系统扩展

CLI (praisonai) – 使用 pip install praisonai 安装以进行终端控制。
Claw Dashboard – 将代理连接到 Telegram/Slack/Discord (pip install "praisonai[claw]")。
Flow Visual Builder – 拖放式工作流程编辑器 (pip install "praisonai[flow]")。
UI – 聊天风格界面 (pip install "praisonai[ui]")。
JavaScript SDK – npm install praisonai 用于 Node/浏览器使用。

🎯 典型应用场景

领域	示例
研究与分析	自动收集论文、总结、制作洞察表格
代码生成	在仓库中编写、调试、重构代码
内容创作	多代理团队制作博客、文档、营销文案
数据管道	从 API/数据库提取、转换并可视化结果
客户支持	在聊天平台上具有记忆和知识库的 24/7 机器人
工作流程自动化	链接代理以分类工单、执行测试、部署构建

📚 文档与资源

完整文档： docs.praison.ai
examples/python/managed-agents/ 中有 20 个可执行的示例
examples/python/providers/ 下有特定提供者的代码片段
可视化流程可用 YAML 表达，无需 Python。

🏷️ 授权与社区

MIT License – 可免费商用及个人使用。
安装统计徽章显示总下载量。
在 Trendshift 上趋势热门，并在 X (前 Twitter) 上被推荐。

🔗 快速链接

GitHub: https://github.com/MervinPraison/PraisonAI
下载二进制文件: README 中的 macOS / Windows / Linux 徽章
安装脚本: curl -fsSL https://praison.ai/install.sh | bash

PraisonAI 旨在为开发人员提供一个完整的堆叠，用于构建、部署和管理自主 AI 代理，而无需拼凑多个库。