MervinPraison /PraisonAI
Private AI agents for highly regulated teams, and for anyone who wants AI on their own computer. Open-source Python agent framework that runs fully offline.
★ 9,337⑂ 1,507👁 69⑃ 3,788● 2,536▤ 866
+1
日增长
9,337
stars
1,507
forks
69
watchers
3,788
prs
2,536
issues
866
releases
README
PraisonAI
Private AI that earns trust one task at a time.
PraisonAI runs AI agents on your own computers, even fully offline, so private data never has to leave the building.
- For highly regulated teams (early access): each task moves to your own AI only after it passes a test. If quality slips, it moves back automatically, and every step is recorded for regulators. How it works
- For everyone else: a free, open-source Python agent framework. With a local model you need no API key and pay no cloud bill, and your files stay yours.
2M+ downloads · 9.3K stars · 600+ releases in the last year · 80+ contributors · Python
bash
pip install praisonai
Only need the Python library? pip install praisonaiagents installs just the lightweight core.
Using PraisonAI for something else?
PraisonAI is still a general-purpose, open-source agent framework, and everything works as before: the same packages, imports, commands and examples. Go straight to what you came for:
- Agents and multi-agent teams: Agents · Handoffs
- Workflows: AgentFlow: route, parallel, loop, repeat
- Memory and knowledge: Memory · Knowledge · RAG
- Tools and MCP: Tools · MCP
- Bots (Telegram, Discord, Slack, WhatsApp): Bot CLI · Bot gateway
- Terminal CLI: praisonai code · praisonai run · praisonai chat · CLI reference
- Training and fine-tuning: PraisonAI Train
- Browser automation: Browser agent · Browser CLI
- Sandboxes: Sandboxed code execution
- Deploy: Deploy guide
- Dashboard and UI: Claw dashboard · Chat UI
- YAML, no code: YAML agents · YAML reference
- JavaScript and TypeScript: JavaScript SDK
- Desktop app: PraisonAI Desktop · Downloads
- Everything else: the full feature reference further down this page
Quick start
Set a key for any supported provider (OpenAI shown here), or skip the key and use a local model as in the next section.
bash
export OPENAI_API_KEY="your-api-key"
python
from praisonaiagents import Agent
agent = Agent(instructions="You are a helpful assistant.")
print(agent.start("In two sentences, why do some companies keep their data on their own computers?"))
Run fully offline
Run the same agent on a model on your own computer with Ollama. You need no API key, and your prompts and answers stay on the machine.
Install the package and pull the model while you still have internet; after that, the agent runs with no network at all. If you installed only the core library, use pip install "praisonaiagents[llm]", which adds the local-model support.
bash
Start Ollama first (the app, or "ollama serve" in another terminal)
ollama pull llama3.2
export DO_NOT_TRACK=true keeps telemetry off (PraisonAI sends none unless you turn it on)
python
from praisonaiagents import Agent
agent = Agent(instructions="You are a helpful assistant.", model="ollama/llama3.2")
print(agent.start("Why is the sky blue?"))
If Ollama runs on another computer on your network, pass base_url (or set OLLAMA_API_BASE):
python
agent = Agent(instructions="...", model="ollama/llTop issues
#603wp20 comments · 2025-06-04#821autogen to ag2 conversion12 comments · 2025-07-11#738Review existing features11 comments · 2025-07-07#737Review code base11 comments · 2025-07-07#820review crewai implementation9 comments · 2025-07-11#763Review files and functions9 comments · 2025-07-08#579Open Telemetry9 comments · 2025-06-03#4528[REGRESSION] Desktop v4.7.3 Windows — engine still never starts (setup needed) in Latest shipped build after #4441 closed8 comments · 2026-08-28
Discussions
#6366[Security Audit] Multiple vulnerabilities identified: Sandbox Escape (RCE), hardcoded PostHog key, Phone Home and command injection !!!1 comments · 2026-11-14#5063Recording a PraisonAI agent and replaying it offline — and the env-var precedence that surprised me0 comments · 2026-09-13#5011Expose the resolved tool identity to native pre-execution hooks0 comments · 2026-09-08#3625Agent Only MCP with PraisonAI: reuse verified debugging evidence0 comments · 2026-08-03#2144[免费安全体检] MervinPraison/PraisonAI — 三大安全风险 & 修复建议0 comments · 2026-06-22#1786AI PR Review: feedback on PR review evidence packet0 comments · 2026-06-01#1387PraisonAI + LiteLLM / Ollama / Azure — what's your setup?0 comments · 2026-04-15#1386How are YOU using PraisonAI? Share your workflows, wins, and wild experiments!0 comments · 2026-04-15
Latest release
PraisonAI v4.7.25 v4.7.25 2026-11-14Release v4.7.25