<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="src/praisonai/praisonai/public/logo_dark.png" /> <source media="(prefers-color-scheme: light)" srcset="src/praisonai/praisonai/public/logo_light.png" /> <img alt="PraisonAI Logo" src="src/praisonai/praisonai/public/logo_light.png" width="250" /> </picture> </p> <!-- mcp-name: io.github.MervinPraison/praisonai --> <p align="center"> <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://static.pepy.tech/badge/PraisonAI" alt="Total Downloads" /></a> <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://img.shields.io/github/v/release/MervinPraison/PraisonAI" alt="Latest Stable Version" /></a> <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License" /></a> <a href="https://registry.modelcontextprotocol.io/servers/io.github.MervinPraison/praisonai"><img src="https://img.shields.io/badge/MCP-Registry-blue" alt="MCP Registry" /></a> </p> <div align="center">

PraisonAI 🦞

<a href="https://trendshift.io/repositories/9130" target="_blank"><img src="https://trendshift.io/api/badge/repositories/9130" alt="MervinPraison%2FPraisonAI | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

</div>

PraisonAI 🦞 — Automate and solve complex challenges with AI agent teams that plan, research, code, and deliver results to Telegram, Discord, and WhatsApp — running 24/7. A low-code, production-ready multi-agent framework with handoffs, guardrails, memory, RAG, and 100+ LLM providers, built around simplicity, customisation, and effective human-agent collaboration.

<p align="center"> <img src="src/praisonai/praisonai/public/dashboard.png" alt="PraisonAI Dashboard" width="800" /> </p> <div align="center"> <a href="https://docs.praison.ai"> <p align="center"> <img src="https://img.shields.io/badge/📚_Documentation-Visit_docs.praison.ai-blue?style=for-the-badge&logo=bookstack&logoColor=white" alt="Documentation" /> </p> </a> </div>

---

Quick Paths:

• 🆕 New here? → Quick Start (1 minute to first agent)
• 📦 Installing? → Installation
• 🐍 Python SDK? → Python Examples
• 🎯 CLI user? → CLI Quick Reference
• 🤝 Contributing? → Development

---

⚡ Performance

PraisonAI is built for speed, with agent instantiation in under 4μs. This reduces overhead, improves responsiveness, and helps multi-agent systems scale efficiently in real-world production workloads.

| Performance Metric | PraisonAI | |--------------------|-----------| | Avg Instantiation Time | 3.77 μs |

---

🎯 Use Cases

AI agents solving real-world problems across industries:

| Use Case | Description | |----------|-------------| | 🔍 Research & Analysis | Conduct deep research, gather information, and generate insights from multiple sources automatically | | 💻 Code Generation | Write, debug, and refactor code with AI agents that understand your codebase and requirements | | ✍️ Content Creation | Generate blog posts, documentation, marketing copy, and technical writing with multi-agent teams | | 📊 Data Pipelines | Extract, transform, and analyze data from APIs, databases, and web sources automatically | | 🤖 Customer Support | Deploy 24/7 support bots on Telegram, Discord, Slack with memory and knowledge-backed responses | | ⚙️ Workflow Automation | Automate multi-step business processes with agents that hand off tasks, verify results, and self-correct |

---

Supported Providers

PraisonAI supports 100+ LLM providers through seamless integration:

<p align="center"> <img src="https://img.shields.io/badge/OpenAI-412991?style=flat&logo=openai&logoColor=white" alt="OpenAI" /> <img src="https://img.shields.io/badge/Anthropic-191919?style=flat&logo=anthropic&logoColor=white" alt="Anthropic" /> <img src="https://img.shields.io/badge/Google_Gemini-4285F4?style=flat&logo=google&logoColor=white" alt="Google Gemini" /> <img src="https://img.shields.io/badge/DeepSeek-566AB2?style=flat" alt="DeepSeek" /> <img src="https://img.shields.io/badge/Azure-0078D4?style=flat&logo=microsoftazure&logoColor=white" alt="Azure" /> <img src="https://img.shields.io/badge/Ollama-000000?style=flat" alt="Ollama" /> <img src="https://img.shields.io/badge/Groq-F05237?style=flat" alt="Groq" /> <img src="https://img.shields.io/badge/Mistral-FF7000?style=flat" alt="Mistral" /> <img src="https://img.shields.io/badge/Cerebras-F05A28?style=flat" alt="Cerebras" /> <img src="https://img.shields.io/badge/Cohere-39594D?style=flat" alt="Cohere" /> <img src="https://img.shields.io/badge/OpenRouter-6467F2?style=flat" alt="OpenRouter" /> <img src="https://img.shields.io/badge/Perplexity-20808D?style=flat" alt="Perplexity" /> <img src="https://img.shields.io/badge/Fireworks-FF6B35?style=flat" alt="Fireworks" /> <img src="https://img.shields.io/badge/AWS_Bedrock-FF9900?style=flat&logo=amazonaws&logoColor=white" alt="AWS Bedrock" /> <img src="https://img.shields.io/badge/xAI_Grok-000000?style=flat" alt="xAI Grok" /> <img src="https://img.shields.io/badge/Vertex_AI-4285F4?style=flat&logo=googlecloud&logoColor=white" alt="Vertex AI" /> <img src="https://img.shields.io/badge/HuggingFace-FFD21E?style=flat&logo=huggingface&logoColor=black" alt="HuggingFace" /> <img src="https://img.shields.io/badge/Together_AI-000000?style=flat" alt="Together AI" /> <img src="https://img.shields.io/badge/Databricks-FF3621?style=flat&logo=databricks&logoColor=white" alt="Databricks" /> <img src="https://img.shields.io/badge/Replicate-262626?style=flat" alt="Replicate" /> <img src="https://img.shields.io/badge/Cloudflare-F38020?style=flat&logo=cloudflare&logoColor=white" alt="Cloudflare" /> </p> <details> <summary><strong>View all 24 providers with examples</strong></summary>

| Provider | Example | |----------|:-------:| | OpenAI | Example | | Anthropic | Example | | Google Gemini | Example | | Ollama | Example | | Groq | Example | | DeepSeek | Example | | xAI Grok | Example | | Mistral | Example | | Cohere | Example | | Perplexity | Example | | Fireworks | Example | | Together AI | Example | | OpenRouter | Example | | HuggingFace | Example | | Azure OpenAI | Example | | AWS Bedrock | Example | | Google Vertex | Example | | Databricks | Example | | Cloudflare | Example | | AI21 | Example | | Replicate | Example | | SageMaker | Example | | Moonshot | Example | | vLLM | Example |

</details>

---

🌟 Why PraisonAI?

| | Feature | How | |--|---------|-----| | 🔌 | MCP Protocol — stdio, HTTP, WebSocket, SSE | tools=MCP("npx ...") | | 🧠 | Planning Mode — plan → execute → reason | planning=True | | 🔍 | Deep Research — multi-step autonomous research | Docs | | 🤖 | External Agents — orchestrate Claude Code, Gemini CLI, Codex | Docs | | 🔄 | Agent Handoffs — seamless conversation passing | handoff=True | | 🛡️ | Guardrails — input/output validation | Docs | | | Web Search + Fetch — native browsing | web_search=True | | 🪞 | Self Reflection — agent reviews its own output | Docs | | 🔀 | Workflow Patterns — route, parallel, loop, repeat | Docs | | 🧠 | Memory (zero deps) — works out of the box | memory=True |

<details> <summary><strong>View all 25 features</strong></summary>

| | Feature | How | |--|---------|-----| | 💡 | Prompt Caching — reduce latency + cost | prompt_caching=True | | 💾 | Sessions + Auto-Save — persistent state across restarts | auto_save="my-project" | | 💭 | Thinking Budgets — control reasoning depth | thinking_budget=1024 | | 📚 | RAG + Quality-Based RAG — auto quality scoring retrieval | Docs | | 📊 | Model Router — auto-routes to cheapest capable model | Docs | | 🧊 | Shadow Git Checkpoints — auto-rollback on failure | Docs | | 📡 | A2A Protocol — agent-to-agent interop | Docs | | 📏 | Context Compaction — never hit token limits | [Docs](https://docs.praison.ai/docs/features/context-co