PraisonAI

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

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.

export OPENAI_API_KEY="your-api-key"

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.

# 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)

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):

agent = Agent(instructions="...", model="ollama/llama3.2", base_url="http://192.168.1.10:11434")

vLLM and LM Studio work the same way: use hosted_vllm/ (vLLM) or lm_studio/ with your server's base_url. More in the Ollama guide and Models docs.

How the handover works (early access)

1. Watch: records how each task is done today.
2. Test: your own AI takes an exam made from real past work it never studied.
3. Hand over: a task moves to your own AI only when it passes.
4. Roll back: if quality drops, the task moves back automatically.
5. Record: every handover leaves a record your regulator can check.

What is "your own AI"? An open model, such as Llama, Qwen or Gemma, running on your own computers. Use it as it is, or train it on your own past work with PraisonAI Train on your own GPU servers. Your team decides when to train; nothing trains automatically. Either way, a task moves to it only after it passes that exam.

Highly regulated teams, such as banks, insurers and hospitals, want AI but can't send customer data to outside models. From 6 January 2027, OpenAI also takes no new self-serve fine-tuning jobs (notice), so teams that customise models need models they own. The handover lets these teams move work to AI they own, one task at a time, with a record that shows why each step was trusted.

It is built on parts of this framework that are live today: tracing, evaluation, fine-tuning, model routing and local models. The handover itself is in early access, and we are taking on our first design partners. To take part, see praison.ai/enterprise.

Features

• Agents and multi-agent teams: Agents · Handoffs · Workflows
• Memory: Memory · Knowledge and RAG · Sessions
• Tools and MCP: Tools · MCP
• Guardrails and approval: Guardrails · Human approval · Policy engine
• Tracing and evaluation: Tracing · Telemetry · Langfuse · Evaluation
• Your choice of model: Models · Model router
• Fine-tuning: PraisonAI Train
• Deploy: Deploy guide

JavaScript and TypeScript

npm install praisonai

The TypeScript and JavaScript SDK has its own guide at praison.ai/docs/js. A short example is in Using JavaScript Code below.

The company

• Who: Praison AI Limited in Cambridge, UK, building PraisonAI since September 2023. Co-founders Mervin Praison (CEO), Leebana Smith (COO) and Karthick Subramanian (CBO). About us
• What we're building: the task handover above, as a self-hosted product on top of this framework. It is in early access, and we are taking on our first design partners.
• Why now: highly regulated teams want AI but can't send customer data to outside models, and from 6 January 2027 OpenAI takes no new self-serve fine-tuning jobs.
• How it fits together: the framework stays free and MIT-licensed, and brings developers in. Regulated teams license the handover to run inside their own walls.
• Traction: every number at the top of this page is public and linked to its source.
• Get in touch: design partners, investors and press: enterprise@praison.ai or praison.ai/enterprise

Docs, community and licence

• Documentation: praison.ai/docs
• Questions and bugs: Discussions · Issues
• Contributing: Contributing guide
• Videos and news: YouTube · X · LinkedIn
• Desktop app: macOS, Windows and Linux builds are on the latest release
• Licence: MIT

---

Full feature reference

Everything below is the full reference that was on this page before. Nothing has been removed; the longest parts are folded, so click a heading's summary to open it.

Desktop app

Other ways to install

One-line installer:

curl -fsSL https://praison.ai/install.sh | bash

The full praisonai package, with the CLI, bots, dashboard and integrations:

 ██████╗ ██████╗  █████╗ ██╗███████╗ ██████╗ ███╗   ██╗     █████╗ ██╗

██╔══██╗██╔══██╗██╔══██╗██║██╔════╝██╔═══██╗████╗ ██║ ██╔══██╗██║ ██████╔╝██████╔╝███████║██║███████╗██║ ██║██╔██╗ ██║ ███████║██║ ██╔═══╝ ██╔══██╗██╔══██║██║╚════██║██║ ██║██║╚██╗██║ ██╔══██║██║ ██║ ██║ ██║██║ ██║██║███████║╚██████╔╝██║ ╚████║ ██║ ██║██║ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚══════╝ ╚═════╝ ╚═╝ ╚═══╝ ╚═╝ ╚═╝╚═╝

pip install praisonai

<a hre