Open-source Python framework for orchestrating role-based autonomous AI agents (Crews) and event-driven workflows (Flows).
MervinPraison/PraisonAI
Python framework for building autonomous AI agents that research, plan, code and run tasks, with memory, RAG and 100+ LLM providers.
- Stars
- 9,279
- Forks
- 1,486
- Open issues
- 134
- Last commit
- 5 hours ago
What is it?
PraisonAI is a framework for building AI agents that can research, plan, write code and execute multi-step tasks. It ships a core Python SDK (praisonaiagents) for defining agents with instructions, tools, memory and knowledge, plus a CLI, a YAML mode for running agent teams without code, and optional packages for a chat UI, a Langflow-based visual flow builder and a Telegram, Slack, Discord and WhatsApp dashboard.
Agents can be combined into teams, handoffs, and workflow patterns such as routing, parallel execution, loops and evaluator-optimizer cycles. The project supports MCP tools over stdio, HTTP, WebSocket and SSE, persistent memory and sessions backed by databases such as PostgreSQL, SQLite and MongoDB, and retrieval over local documents. Tools can optionally run in remote sandboxes such as Docker, E2B or Modal.
The framework is designed to work with more than 100 LLM providers, including OpenAI, Anthropic, Gemini and local models through Ollama or vLLM.
Key features
- 01Single and multi-agent teams with handoffs between agents
- 02MCP tool integration over stdio, HTTP, WebSocket and SSE
- 03Persistent memory, sessions and knowledge retrieval (RAG)
- 04Workflow patterns including routing, parallel execution and loops
- 05Tools can run in Docker, E2B, Modal and other sandboxes
- 06Support for 100+ LLM providers, including local models
Use cases
- Automating research and report writing across multiple sources
- Building customer support bots on Telegram, Slack or Discord with memory
- Orchestrating coding agents and multi-step code generation tasks
- Creating data pipeline agents that query APIs and databases
Quick start
- 1
Install the lightweight core SDK
pip install praisonaiagents - 2
Set your LLM provider API key (the example uses OpenAI)
export OPENAI_API_KEY="your-api-key" - 3
Run the first agent from a Python script using the Agent class
Things to know
- The quick start needs an API key from a paid LLM provider such as OpenAI.
- Advanced sandbox features such as Docker, E2B or Modal require their own accounts or infrastructure.
Topics
FAQ
- What is PraisonAI?
- Python framework for building autonomous AI agents that research, plan, code and run tasks, with memory, RAG and 100+ LLM providers. PraisonAI is a framework for building AI agents that can research, plan, write code and execute multi-step tasks. It ships a core Python SDK (praisonaiagents) for defining agents with instructions, tools, memory and knowledge, plus a CLI, a YAML mode for running agent teams without code, and optional packages for a chat UI, a Langflow-based visual flow builder and a Telegram, Slack, Discord and WhatsApp dashboard.
- Is PraisonAI free to use? What license does it have?
- PraisonAI is open source under the MIT license. Check the license terms before using it in commercial products.
- Is PraisonAI still maintained?
- Actively maintained. The last commit to PraisonAI was on Oct 20, 2026.
- What can I use PraisonAI for?
- Automating research and report writing across multiple sources Building customer support bots on Telegram, Slack or Discord with memory Orchestrating coding agents and multi-step code generation tasks Creating data pipeline agents that query APIs and databases
- How do I install PraisonAI?
- Install the lightweight core SDK: pip install praisonaiagents Set your LLM provider API key (the example uses OpenAI): export OPENAI_API_KEY="your-api-key" Run the first agent from a Python script using the Agent class
- Where can I get PraisonAI?
- The source code and installation instructions are on GitHub: https://github.com/MervinPraison/PraisonAI
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
AutoGPT is an open-source platform for building, running, and scheduling AI agents that carry out multi-step workflows from plain-English descriptions or a visual builder.
A visual platform for building, testing and deploying AI agents and workflows, with built-in API and MCP server exposure.
A Python framework for building LLM-powered applications and agents, with standard interfaces for models, embeddings, vector stores and third-party integrations.
Self-hosted personal AI agent framework in Python with a browser WebUI, terminal client, chat app channels, tools, memory and MCP support.
A minimal Python library for building AI agents that write and run their actions as Python code.