> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Praison AI
> PraisonAI is a production-ready Multi-AI Agents framework with self-reflection, designed to create AI Agents to automate and solve problems ranging from simple tasks to complex challenges. It provides a low-code solution to streamline the building and management of multi-agent LLM systems, emphasising simplicity, customisation, and effective human-agent collaboration.
Build production-ready AI agents that reason, remember, self-improve, and act autonomously — with just a few lines of code.
***
## Why PraisonAI?
Your machine, cloud, or edge. Self-hosted with full control over your data.
OpenAI, Anthropic, Google, Ollama, Groq — seamlessly switch between any provider.
Persistent memory, RAG knowledge bases, and context-aware conversations.
Agents that evaluate and improve their own responses for higher accuracy.
Web search, file operations, databases, APIs — all ready to use out of the box.
Sequential, parallel, hierarchical orchestration with autonomous coordination.
***
## Differentiators
Unlike simple chatbots, PraisonAI agents can **reflect on their outputs** and iteratively improve them. Built-in reasoning capabilities enable multi-step problem solving without manual prompting.
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent, ReflectionConfig
# Simple reflection
agent = Agent(
name="analyst",
instructions="You analyze data carefully.",
reflection=True # Enable self-correction
)
# Advanced reflection with custom iterations
agent = Agent(
name="analyst",
instructions="You analyze data carefully.",
reflection=ReflectionConfig(max_iterations=3)
)
```
Agents remember past interactions across sessions. Short-term, long-term, and episodic memory systems keep context without re-prompting.
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent, MemoryConfig
agent = Agent(
name="assistant",
memory=MemoryConfig(
backend="file",
user_id="user_123"
)
)
```
Connect agents to your documents, databases, and APIs. Built-in RAG with auto-chunking, embeddings, and semantic search.
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent
agent = Agent(
name="researcher",
knowledge=[ # Multiple knowledge sources
"./docs/",
"https://example.com/api",
"./pdfs/"
]
)
```
Agents can navigate websites, fill forms, click buttons, and extract data — fully automated browser automation.
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
agent = Agent(
name="web_agent",
tools=["browser_tool"], # Built-in browser
llm="gpt-4o"
)
agent.run("Book a flight from NYC to LA for next Tuesday")
```
Deploy agents to Slack, Discord, Telegram, WhatsApp, Signal, LINE, iMessage, and more — with a single command.
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai bot slack --token $SLACK_BOT_TOKEN --app-token $SLACK_APP_TOKEN
```
Write custom tools in Python or use any of the 140+ pre-built integrations. MCP protocol support for external tool servers.
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent
def custom_tool(query: str) -> str:
"""My custom tool description."""
return f"Result for {query}"
agent = Agent(tools=[custom_tool])
```
***
## Quick Start
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
pip install praisonai
```
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
export OPENAI_API_KEY=sk-xxx
```
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai --auto "Research the top 5 AI trends in 2025 and create a report"
```
That's it! Agents are automatically created and orchestrated.
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
pip install praisonaiagents
```
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent
agent = Agent(
name="researcher",
instructions="You are a research analyst specializing in AI trends.",
llm="gpt-4o"
)
result = agent.start("What are the top AI trends for 2025?")
print(result)
```
```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent, Task, AgentTeam
# Create specialized agents
researcher = Agent(
name="Researcher",
role="Research Analyst",
goal="Find accurate, up-to-date information",
llm="gpt-4o"
)
writer = Agent(
name="Writer",
role="Content Writer",
goal="Create engaging, clear content",
llm="gpt-4o"
)
# Define tasks
research_task = Task(
name="research",
description="Research AI trends for 2025",
agent=researcher
)
write_task = Task(
name="write",
description="Write a blog post based on the research",
agent=writer
)
# Orchestrate
agents = AgentTeam(
agents=[researcher, writer],
tasks=[research_task, write_task],
process="sequential"
)
result = agents.start()
```
***
## Platform Integrations
Deploy AI bots to Slack workspaces
Create Discord bots with agent intelligence
Build Telegram bots in minutes
Send messages via WhatsApp Business
Automate repos, issues, and PRs
Calendar, Sheets, Drive, Gmail
Read and write Notion pages
Manage Jira issues and projects
***
## CLI Commands
Full-featured CLI for deploying and managing AI agents:
```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
# Discord with custom tools
praisonai bot discord --token $DISCORD_BOT_TOKEN \
--tools DuckDuckGoTool WikipediaTool
```
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Navigate and interact with websites
praisonai browser navigate https://example.com
praisonai browser run "Click the submit button"
praisonai browser screenshot --output page.png
praisonai browser doctor
```
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Manage skills
praisonai skills list
praisonai skills check --verbose
praisonai skills create --name csv-analyzer --description "Analyze CSV" --script
# Manage plugins
praisonai plugins list --enabled
praisonai plugins doctor
```
```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Secure execution
praisonai "Run code" --sandbox strict
praisonai sandbox status
praisonai sandbox explain --agent work
```
Deploy messaging bots
Browser automation
Manage agent skills
Plugin management
***
## Architecture
```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph TB
subgraph "Your Application"
U[👤 User] --> A[🤖 PraisonAI Agents]
end
subgraph "Agent Capabilities"
A --> T[🔧 140+ Tools]
A --> M[💾 Memory]
A --> K[📚 Knowledge]
A --> R[🧠 Reasoning]
end
subgraph "Deployment Options"
A --> CLI[⌨️ CLI]
A --> API[🌐 REST API]
A --> BOT[💬 Messaging Bots]
A --> UI[🖥️ Web UI]
end
subgraph "LLM Providers"
A --> LLM[OpenAI / Anthropic / Google / Ollama / 100+]
end
classDef user fill:#6366F1,stroke:#7C90A0,color:#fff
classDef agent fill:#8B0000,stroke:#7C90A0,color:#fff
classDef capability fill:#2E8B57,stroke:#7C90A0,color:#fff
classDef deploy fill:#189AB4,stroke:#7C90A0,color:#fff
classDef llm fill:#F59E0B,stroke:#7C90A0,color:#fff
class U user
class A agent
class T,M,K,R capability
class CLI,API,BOT,UI deploy
class LLM llm
```
***
## Use Cases
Build intelligent support agents that resolve issues autonomously, escalate when needed, and learn from interactions.
Create agents that gather data, analyze trends, and produce detailed reports with citations.
Deploy agents that research, write, edit, and optimize content across formats — blogs, docs, social media.
Automate complex workflows with multi-agent coordination — from data pipelines to deployment.
Agents that understand your codebase, write tests, fix bugs, and implement features.
Build assistants that manage calendars, emails, reminders, and integrate with your tools.
***
## Explore
Create and configure intelligent agents
140+ built-in tools and integrations
Persistent memory and knowledge bases
Model Context Protocol integrations
Slack, Discord, Telegram, and more
Full SDK documentation
***
