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
PythonMITCreated 2024-03-19praison.ai
下载:PraisonAI v4.7.25PraisonAI-4.7.25 ↓4.7.252026-11-14
+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/ll

Top issues

Discussions

Latest release

PraisonAI v4.7.25 v4.7.25 2026-11-14
Release v4.7.25

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON