> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Praison AI

> PraisonAI runs AI agents on your own computers, even fully offline, so private data never has to leave the building. It is built for highly regulated teams, and free and open source for everyone.

![PraisonAI Logo](https://mintcdn.com/praisonai/pFBcVNzCyPC2mUmz/images/praisonai-logo-black.png?fit=max\&auto=format\&n=pFBcVNzCyPC2mUmz\&q=85\&s=1d90f4757248c0a22dd9e53f8bd5e0ef)

# 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. It is built for highly regulated teams, and free and open source for everyone.

![Downloads](https://static.pepy.tech/badge/PraisonAI)

![Stars](https://img.shields.io/github/stars/MervinPraison/PraisonAI?style=social)

![Forks](https://img.shields.io/github/forks/MervinPraison/PraisonAI?style=social)

Search documentation...
⌘K

> [card] [Get Started](https://praison.ai/docs/quickstart.md)
>
> Build your first AI agent in minutes. Install, configure, and run.

> [card] [Explore SDK](https://praison.ai/docs/introduction.md)
>
> Agents, Tools, Workflows, Memory, Knowledge, and RAG capabilities.

> [card] [Deploy](https://praison.ai/docs/deploy/index.md)
>
> Docker, Cloud, MCP Server, A2A Protocol, and production patterns.

## Quick Start

One‑line install — includes guided onboarding for Telegram, Discord, Slack, WhatsApp and the Claw dashboard.

> [tab] macOS / Linux / WSL2
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> curl -fsSL https://praison.ai/install.sh | bash
> ```
>
> Isolated install via `uv tool` → `pipx` → venv fallback. CLI available at `~/.local/bin/praisonai`.

> [tab] Windows (PowerShell)
>
> ```powershell theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> iwr -useb https://praison.ai/install.ps1 | iex
> ```

> [tab] uvx (zero-install)
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> uvx praisonai "2+2"
> ```
>
> Runs PraisonAI without a permanent install. Requires [uv](https://github.com/astral-sh/uv).

> [tab] pipx
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> pipx install praisonai
> ```
>
> Isolated persistent install. Requires [pipx](https://pipx.pypa.io/).

> [tab] pip
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> pip install "praisonai[all]"
> praisonai onboard
> ```

Single Agent

AgentClaw

Multi-Agent

Workflow

App

> [tab] Agent
>
> ```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> from praisonaiagents import Agent
>
> agent = Agent(instructions="You are a helpful AI assistant")
> agent.start("Write a movie script about a robot on Mars")
> ```

> [tab] 🦞 AgentClaw
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> pip install "praisonai[claw]"
> praisonai claw
> ```
>
> Open **[http://localhost:8082](http://localhost:8082)** — full UI with chat, agents, memory,
> knowledge, and channels for Telegram, Discord, Slack.

> [tab] AgentTeam
>
> ```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> from praisonaiagents import Agent, AgentTeam
>
> researcher = Agent(name="Researcher", instructions="Research topics thoroughly")
> writer = Agent(name="Writer", instructions="Write engaging content")
>
> team = AgentTeam(agents=[researcher, writer])
> team.start("Create a blog post about AI agents")
> ```

> [tab] AgentFlow
>
> ```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> from praisonaiagents import Agent, AgentFlow
>
> researcher = Agent(name="Researcher", instructions="Research topics")
> writer = Agent(name="Writer", instructions="Write content")
>
> workflow = AgentFlow(steps=[researcher, writer])
> workflow.start("Create a blog post about AI agents")
> ```

> [tab] AgentOS
>
> ```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> from praisonai import AgentOS
> from praisonaiagents import Agent
>
> # Deploy as web API
> app = AgentOS(
>     agents=[Agent(instructions="You are a helpful assistant")]
> )
> app.serve(port=8080)
> ```

## Dashboard

![PraisonAI Dashboard](https://mintcdn.com/praisonai/pFBcVNzCyPC2mUmz/images/dashboard.png?fit=max\&auto=format\&n=pFBcVNzCyPC2mUmz\&q=85\&s=792ef767d503cc1fc3fa7c4f52217b87)

## Works With Every AI Provider

100+ LLM providers supported out of the box

![OpenAI](https://img.shields.io/badge/OpenAI-412991?style=flat\&logo=openai\&logoColor=white)

![Anthropic](https://img.shields.io/badge/Anthropic-191919?style=flat\&logo=anthropic\&logoColor=white)

![Google Gemini](https://img.shields.io/badge/Google_Gemini-4285F4?style=flat\&logo=google\&logoColor=white)

![DeepSeek](https://img.shields.io/badge/DeepSeek-566AB2?style=flat)

![Azure](https://img.shields.io/badge/Azure-0078D4?style=flat\&logo=microsoftazure\&logoColor=white)

![Ollama](https://img.shields.io/badge/Ollama-000000?style=flat)

![Groq](https://img.shields.io/badge/Groq-F05237?style=flat)

![Mistral](https://img.shields.io/badge/Mistral-FF7000?style=flat)

![Cerebras](https://img.shields.io/badge/Cerebras-F05A28?style=flat)

![Cohere](https://img.shields.io/badge/Cohere-39594D?style=flat)

![OpenRouter](https://img.shields.io/badge/OpenRouter-6467F2?style=flat)

![Perplexity](https://img.shields.io/badge/Perplexity-20808D?style=flat)

![Fireworks](https://img.shields.io/badge/Fireworks-FF6B35?style=flat)

![AWS Bedrock](https://img.shields.io/badge/AWS_Bedrock-FF9900?style=flat\&logo=amazonaws\&logoColor=white)

![xAI Grok](https://img.shields.io/badge/xAI_Grok-000000?style=flat)

![Vertex AI](https://img.shields.io/badge/Vertex_AI-4285F4?style=flat\&logo=googlecloud\&logoColor=white)

![HuggingFace](https://img.shields.io/badge/HuggingFace-FFD21E?style=flat\&logo=huggingface\&logoColor=black)

![Together AI](https://img.shields.io/badge/Together_AI-000000?style=flat)

![Databricks](https://img.shields.io/badge/Databricks-FF3621?style=flat\&logo=databricks\&logoColor=white)

![Replicate](https://img.shields.io/badge/Replicate-262626?style=flat)

![Cloudflare](https://img.shields.io/badge/Cloudflare-F38020?style=flat\&logo=cloudflare\&logoColor=white)

[![80+ more providers](https://img.shields.io/badge/+_80_more_→-4f46e5?style=flat)](https://praison.ai/docs/models.md)

## Use Cases

AI agents solving real-world problems across industries

> [card] Research & Analysis
>
> Conduct deep research, gather information, and generate insights from multiple sources automatically.

> [card] Code Generation
>
> Write, debug, and refactor code with AI agents that understand your codebase and requirements.

> [card] Content Creation
>
> Generate blog posts, documentation, marketing copy, and technical writing with multi-agent teams.

> [card] Data Pipelines
>
> Extract, transform, and analyze data from APIs, databases, and web sources automatically.

> [card] Customer Support
>
> Deploy 24/7 support bots on Telegram, Discord, Slack with memory and knowledge-backed responses.

> [card] Workflow Automation
>
> Automate multi-step business processes with agents that hand off tasks, verify results, and self-correct.

## Why PraisonAI?

> [card] Runs Anywhere
>
> Your machine, cloud, or edge. Self-hosted with full control over your data.

> [card] 100+ LLM Models
>
> OpenAI, Anthropic, Google, Ollama, Groq — seamlessly switch between any provider.

> [card] Memory & Knowledge
>
> Persistent memory, RAG knowledge bases, and context-aware conversations.

> [card] Self-Reflection
>
> Agents that evaluate and improve their own responses for higher accuracy.

> [card] 140+ Built-in Tools
>
> Web search, file operations, databases, APIs — all ready to use out of the box.

> [card] Multi-Agent Workflows
>
> Sequential, parallel, hierarchical orchestration with autonomous coordination.

## Install

> [tab] Python
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> pip install praisonaiagents
> export OPENAI_API_KEY=your_key
> ```
>
> ```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> from praisonaiagents import Agent
>
> agent = Agent(instructions="You are a helpful AI assistant")
> agent.start("Write a movie script about a robot on Mars")
> ```

> [tab] JavaScript
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> npm install praisonai
> export OPENAI_API_KEY=your_key
> ```
>
> ```javascript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> const { Agent } = require('praisonai');
> const agent = new Agent({ instructions: 'You are a helpful AI assistant' });
> agent.start('Write a movie script about a robot on Mars');
> ```

> [tab] No Code
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> pip install praisonai
> export OPENAI_API_KEY=your_key
> praisonai "Summarize the latest AI news"
> ```

> [tab] Low Code
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> pip install praisonai
> export OPENAI_API_KEY=your_key
> ```
>
> ```yaml agents.yaml theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> agents:
>   researcher:
>     instructions: Research about AI trends
>   writer:
>     instructions: Write a blog post about the findings
> ```
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> praisonai agents.yaml
> ```
>
> The same `--continue`, `--session`, `--output`, and permission flags documented for [`praisonai run`](https://praison.ai/docs/cli/run) also work here — `praisonai agents.yaml --continue --output json` resumes the last session and emits machine-parseable output.

## Explore

> [card] [Agents](https://praison.ai/docs/agents/agents.md)
>
> Single agents, multi-agent teams, coordination

> [card] [Tools](https://praison.ai/docs/tools/tools.md)
>
> Built-in tools, custom tools, MCP integration

> [card] [Workflows](https://praison.ai/docs/features/workflows.md)
>
> Multi-step pipelines, routing, loops

> [card] [Memory & RAG](https://praison.ai/docs/features/rag.md)
>
> Vector stores, knowledge bases, retrieval

> [card] [🦞 AgentClaw](https://praison.ai/docs/ui/claw.md)
>
> Full UI with chat, agents, Telegram, Discord, Slack

> [card] [Recipes](https://praison.ai/docs/examples/agent-recipes/index.md)
>
> 55+ production-ready AI tools

## Platform Integrations

> [card] [Slack](https://praison.ai/docs/ui/claw.md)
>
> Deploy AI bots to Slack workspaces

> [card] [Discord](https://praison.ai/docs/ui/claw.md)
>
> Create Discord bots with agent intelligence

> [card] [Telegram](https://praison.ai/docs/ui/claw.md)
>
> Build Telegram bots in minutes

> [card] [WhatsApp](https://praison.ai/docs/ui/claw.md)
>
> Connect via WhatsApp Business

> [card] [GitHub](https://praison.ai/docs/tools/tools.md)
>
> Automate repos, issues, and PRs

> [card] [Google](https://praison.ai/docs/tools/tools.md)
>
> Calendar, Sheets, Drive, Gmail

> [card] [Notion](https://praison.ai/docs/tools/tools.md)
>
> Read and write Notion pages

> [card] [Jira](https://praison.ai/docs/tools/tools.md)
>
> Manage Jira issues and projects

## CLI Commands

Full-featured CLI for deploying and managing AI agents

> [tab] 🦞 AgentClaw
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> pip install "praisonai[claw]"
> praisonai claw
>
> # Custom port
> praisonai claw --port 9000
>
> # Add channels from the UI — Telegram, Discord, Slack, WhatsApp
> ```

> [tab] Messaging Bots
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> # Start a Telegram bot
> praisonai bot telegram --token $TELEGRAM_BOT_TOKEN
>
> # Slack with full capabilities
> praisonai bot slack --token $SLACK_BOT_TOKEN --app-token $SLACK_APP_TOKEN \
>   --agent agents.yaml --browser --web --memory --model gpt-4o
>
> # Discord with custom tools
> praisonai bot discord --token $DISCORD_BOT_TOKEN \
>   --tools DuckDuckGoTool WikipediaTool
> ```

> [tab] Browser Control
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> praisonai browser navigate https://example.com
> praisonai browser run "Click the submit button"
> praisonai browser screenshot --output page.png
> praisonai browser doctor
> ```

> [tab] Skills & Plugins
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> praisonai skills list
> praisonai skills check --verbose
> praisonai plugins list --enabled
> praisonai plugins doctor
> ```

> [tab] Sandbox
>
> ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
> PRAISON_SHELL=sandboxed praisonai code
> praisonai sandbox status
> praisonai sandbox explain --agent work
> ```

> [card] [🦞 AgentClaw](https://praison.ai/docs/ui/claw.md)
>
> Full UI with bots and agents

> [card] [Bot CLI](https://praison.ai/docs/cli/bot.md)
>
> Deploy messaging bots

> [card] [Browser CLI](https://praison.ai/docs/cli/browser.md)
>
> Browser automation

> [card] [Plugins CLI](https://praison.ai/docs/cli/plugins.md)
>
> Plugin management

## Join the Community

Connect with developers building with PraisonAI

[GitHub](https://github.com/MervinPraison/PraisonAI)

[YouTube](https://youtube.com/@MervinPraison)

[X](https://x.com/MervinPraison)

[LinkedIn](https://linkedin.com/in/mervinpraison)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.