Praison AI

  • Enterprise
  • Agents
  • Bot
  • Use Cases
  • University
  • Docs
Getting StartedCLIGateway & BotsAgentsCodeUIToolsMCPDeployExamplesSDKJSRustCourse

Getting Started

Getting Started
  • Introduction
  • Installation
  • Quick Start
  • Windows SDK Quickstart
Install
  • Quick Install
  • macOS Desktop App
  • Desktop App
  • Installer Internals
  • Isolation Backends
  • praisonai upgrade
  • praisonai uninstall
  • Update Hint
Core Concepts
  • Agents
  • Core Components
  • AgentTeam
  • AgentFlow
  • AgentOS
  • PraisonAI Claw
  • BotOS
  • Agent Tasks
  • Agent Process Types
  • AI Agents with Tools
  • AI Agents with Context
  • AI Agents with Memory
  • AI Agents with Knowledge
  • RAG (Retrieval Augmented Generation)
  • Agent Planning
  • Agent Reflection
  • Agent Skills
  • Agent Hooks
  • Agent Autonomy
  • Autonomy vs Interactive
  • Ralph Loops
  • Agent Output
  • Agent Execution
  • Budget Management
  • Agent Caching
  • Prompt Templates
  • Agent Templates
  • Web
  • Agent MCP Integration
  • Agent Handoffs
  • Approval
  • Agent Guardrails
  • Input Handling
  • Agent Session Management
  • Agent Evaluation
  • Context / Harness / Loop Engineering
  • Agent Learn
  • Agent Train
  • Learn vs Train
  • Memory vs Learning
  • Context vs Memory
  • Context vs Knowledge
  • Knowledge vs Memory vs Context vs RAG
  • Store Types
  • Storage Paths
  • Hooks vs Callbacks
  • Bot vs Gateway
  • Conditional Execution
  • Migration Guide v1.0
  • Orchestration
Managed Agents
  • Managed Agents
  • Local Managed Agents
  • Docker Compute Agents
  • E2B Cloud Agents
  • Modal Compute Agents
  • Daytona Workspace Agents
Guides
  • Guides
  • Documentation Style Guide
  • praisonai-code package migration
  • Building a Single Agent
  • Building Multi-Agent Systems
  • Run Fully Offline
  • Task handover (early access)
Templates
  • Recipes Guide
  • Create Custom Recipes
  • Use Existing Recipes
  • Add Tools to Recipes
  • Manage Recipes
  • Debug Recipes
  • Different Ways to Create Recipes
Tools
  • Tools Guide
  • Create Custom Tools
  • Assign Tools to Templates
  • Debug Tools
  • Different Ways to Create Tools
  • Remote Tools from GitHub
  • Dynamic Tool Schemas
Workflows
  • Workflows
  • Routing Workflow
  • Parallel Workflow
  • Sequential Workflow
  • Orchestrator Pattern
RAG & Knowledge
  • RAG & Knowledge
  • Knowledge Base Setup
  • Chunking Strategies
  • Retrieval Methods
Persistence
  • Persistence
  • Persistence Overview
  • Database Setup
  • Session Resume
  • Persistence Overview
  • Quickstart
  • Session Resume
  • Async Conversation Store
  • Async State Store
  • Async Knowledge Store
  • MySQL Conversation Store
  • Async DB Hooks
  • Orchestrator-Based Persistence
Deployment
  • Deployment
  • Deployment Overview
  • Docker Deployment
  • Golden Path: Agent → Gateway → Channel → Sandbox
  • Helm Chart (Gateway)
  • Gateway Troubleshooting
Platform
  • Platform Guides
  • Platform Getting Started
  • Platform Quick Tutorial
  • Assign AI Agents to Automate Workflows
  • Organize with Labels & Dependencies
  • Where Platform Lives
  • Assign Work to AI Agents
  • Issue Dependencies
  • Data Model
  • Platform Custom Exceptions
  • Platform Authentication
  • Platform Workspace Management
  • Team Members & RBAC
  • Platform Project Management
  • Platform Issue Tracking
  • Human-Readable Issue IDs
  • Platform Comments & Threaded Replies
  • Platform Agent Management
  • Platform Labels
  • Platform Activity Log
  • Platform Pagination
  • Platform Python SDK Client
  • Platform Client SDK Testing
  • Platform /me Endpoint Bugfix
  • API Route RBAC Enforcement
  • Platform Authentication Configuration
  • Platform SDK Client
  • Platform Python SDK
  • CLI OAuth Login
  • Configuration File
  • Code Migration
  • Platform Labels
  • Platform CLI
  • Project AGENTS.md
  • Runtime Configuration
Recipes
  • Recipe Integration Guide
  • Integration Models
  • Use Cases
  • Personas
  • Decision Guide
Integration Models
  • Integration Models Overview
  • Model 1: Embedded SDK
  • Model 2: CLI Invocation
  • Model 3: Local HTTP Sidecar
  • Model 4: Remote Managed Runner
  • Model 5: Event-Driven
  • Model 6: Plugin Mode
Personas
  • Personas Overview
  • App Developer Persona
  • Platform/DevOps Persona
  • Recipe Author Persona
Blog Generators
  • Image to Blog Generator
  • URL to Blog Generator
Features
  • Packaging & Bundlers
  • Gateway Inbound Hooks
Desktop App
  • PraisonAI Desktop
  • Chat & Streaming
  • Video generation
  • Training
  • Conversations, Projects & Search
  • Approvals & Safety
  • Fine-Tuning
  • Models & API Keys
  • Settings Reference
  • Agent Framework
  • MCP Servers
  • Data & Privacy
  • Environment Variables
  • Engine API
  • Headless CLI
  • First-Run Provisioning
  • Window, Menubar & Lifecycle
  • Engine, Updates & Diagnostics
Mobile App
  • PraisonAI Mobile
  • Getting Started
  • Mobile Architecture
  • Visual Identity
  • Boot Indicator
  • Boot Failures
  • Mobile Engines
  • Shell & Adapters
  • Adapter Conformance
  • Time & Pacing
  • Native Shell (Tauri)
  • Web App (PWA)
  • Shipping to iOS and Android
  • iOS & Android Platform Builds
  • The 11 Events
  • Dropped Events
  • Errors & Recovery
  • Persistence & Keys
  • Native Secrets
  • Settings Screen
  • API Keys
  • Chat Recovery
  • History & Reopen
  • Follow & Jump-to-Latest
  • Composer Behavior
  • Empty Chat
  • Transcript User Row
  • Route Focus & Announcements
  • Human-in-the-loop on Mobile
  • Locale, Direction & Segmentation
  • Capabilities & Gaps
Deploy Surfaces
  • Deploy with Docker Compose
  • Scaffold a Deployment Project
  • Deploy with praisonai deploy helm
  • Helm Chart (Agents API)
  • Deploy to Fly.io
  • Deploy to Railway
  • Deploy to Render
  • 24/7 Production Minimal Guide
Industry Templates
  • Industry Templates
  • Manufacturing Template
  • Energy Template
  • Healthcare Template
  • Agriculture Template
  • Transportation Template
Agent Capabilities
  • Five-Layer Agent Stack
Core Agent Features
  • OpenAI Quickstart
  • Default Framework Change (v1.0.0+)
  • JS Import Safety & Runtimes
  • Python Import Safety & Fork Behaviour
  • JS Credential Rotation
  • PraisonAI Chat
  • Streaming
  • Streaming Tool Events
  • Tool Progress Streaming
  • Deferred & Progress Tools
  • Streaming Progress Feed
  • Streaming Progress Compositor
  • Multimodal Agents
  • Multimodal Tool Output
  • Attachments
  • Image Generation AI Agents
  • Structured AI Agents
  • Mini Agents
  • AutoAgents
  • Auto Mode Providers
  • Auto-Generator Safety
  • ACP Safe Edit Pipeline
  • Auto Tool Inventory
  • Bot Onboarding
  • First-run Onboarding
  • Local-First Run
  • Keyless Local-First Run
  • Local Models
  • Local Model Resolver
  • Local Tool Schemas
  • Direct Prompt (One-Shot CLI)
  • Installation Extras
  • Lean Install (litellm-free)
  • Upgrade & Uninstall
  • LLM Endpoint Configuration
  • Browser & Webview Runtimes
  • LLM Gateways
  • OpenAI-Compatible Server
  • Serve Agents Authentication
  • Agent Invoke Registry
  • YAML Template Variables
  • Templates
  • Bind-Aware Authentication
  • Test Documentation
  • Agents
  • Tools
  • Hosted Tools
  • MCP Integration
  • Serve Agents
  • AgentOS Chat Session Isolation
  • AgentOS Read Endpoints
  • CORS and credentials in AgentOS
  • AgentOS Teams, Flows & WebSocket
  • Caching
  • Append System Prompt
  • Output
  • Token Tracking
  • Cost Tracking
  • Execution
  • Execution Time Caps
  • Step Budget
  • Output Continuation
  • LLM Config
  • Agent Model Resolution
  • Tool Config
  • Learn (Continuous Learning)
  • Memory
  • Memory Prefetch
  • SDK Behavior Matrix
  • Planning
  • Reflection
  • Autonomy
  • Agent Behaviour Flags in YAML
  • Goal-Gated Autonomous Loop
  • Runtime
  • PraisonAI Code CLI
  • Create Custom Agents
  • Agent as Tool
  • Agent-Centric API
  • Legacy Agent Parameters
  • Model Parameter
  • Introspection
  • Knowledge Source Types
  • Parity Notices
Reasoning & Intelligence
  • Reasoning Models
  • Reasoning Agents
  • Reasoning Extract Agents
  • Generate Synthetic Reasoning Data Agents
  • Self Reflection
  • Model Router System
  • LLM-as-Judge
Specialized Agents
  • Code Execution AI Agent
  • Math AI Agent
  • Scientific Writer Agent
  • Meeting Notes Agent
Communication & Messaging
  • Message Steering
  • Messaging Bots
  • Bot Reply Delivery Reliability
  • Webhook Verification
  • Webhook Channel
  • Shared Webhook Ingress
  • Channel Capabilities
  • Gateway Threads
  • Gateway Live Session Handoff
  • Send Policy
  • Multi-Channel Bots
  • Local (Terminal) Channel
  • Email Bot
  • Agent Registry
  • Outbound Media Delivery
  • Linear Bot
  • Automation Suggestions & Blueprints
  • Gateway Channel Directory
  • Per-Chat Session Scope
  • Bot Temporal Grounding
  • Visible-Outcome Guarantee
  • Message Presentation & Inline Keyboards
  • Table & Chart Blocks
  • Poll Blocks
  • Delivery Config
  • Inbound Dead-Letter Queue
  • Outbox Operator CLI
  • Inbound Journal
  • Long-Running Bots
  • Durable Outbound Delivery
  • Durable Outbound Delivery
  • Push Delivery Store
  • Outbound Resilience
  • Outbound Ordering
  • Dead-Target Registry
  • Send Error Taxonomy
  • Undelivered Message Notice
  • Platform-Aware Agents
  • Interactive Bot Actions
  • In-Session Code Review & Security Review
  • Shell Escape
  • Completion Ranking
  • Ask a Side Question with /btw
  • Interactive Callback Payload Store
  • Proactive Delivery
  • Cross-Platform Sessions
  • Real-Time Push Notifications
  • Notification Policy
  • Per-Platform Display Policy
Integration & Infrastructure
  • Host Integration
  • UI Presets
  • Integration Patterns
  • Integration Dashboard Pages
  • AIUI Backend Injection
  • Channels Gateway
  • Access Groups
  • Context Files
  • Instruction Sources
  • Gateway
  • Gateway Liveness
  • Gateway Tiered Diagnostics
  • Gateway Diagnostics Export
  • L3 Dashboard Pages
  • Undelivered-Message Notice
  • Correlation IDs
  • Extensible Gateway Doctor
  • Durable Long-Poll Delivery
  • Redis Pub/Sub Outage Handling
  • Autonomous Loops
  • Autonomy Budget
  • Tool Circuit Breaker
  • Agent Lifecycle Cleanup
  • Prompt Injection Protection
  • Inter-Agent Provenance
  • Sender Attribution Sanitisation
  • Untrusted Request Fencing
  • Memory Trust & Provenance
  • Protected Paths
  • File Tool Workspace Confinement
  • MultiEdit Tool
  • Run Python
  • Audit Logging
  • Tool Search
  • Toolsets
  • OpenAPI Toolset
  • Model-Family Harness
  • Allowed Tools
  • Failover
  • Quota Coordinator
  • Fail-Loud Defaults
  • Reliability
  • Reliability Guarantees
  • Sandbox
  • Placement — where does my agent run?
  • Where Your Agent Runs
  • Sandbox Guarantees
  • OS Sandbox
  • PRAISON_SHELL Modes
  • Code Execution with Tools
  • Sandbox Backends
  • praisonai-sandbox Package
  • Novita Sandbox
  • Cloud Provider Registry
  • External CLI Integrations
  • CLI Backend Protocol
  • Runtime Selection
  • CLI Configuration
  • Env Config Injection
  • XDG Base Directories
  • Editor Support
  • Single-Source Project Config
  • Managed Config
  • Prepared Turn Context
  • Runtime Capabilities
  • Runtime Config Migration
  • Extensible Doctor Rules
  • Optional Dependencies Check
  • Runtime Preflight
  • External Agents in UI
  • Resource Lifecycle
  • Agent Cloning
  • Agent Config Export
Browser Automation
  • praisonai-browser Package
  • Browser Agent Module
  • Browser Agent Deep Dive
  • Offline & CI Install
  • Browser Extension Architecture
  • Browser Bridge Protocol
Workflow Patterns
  • Workflows
  • Step-Result Cache
  • Workflow Diagram
  • Workflow Checkpoint & Resume
  • Workflow Discussion (N-Agent Conversation Loop)
  • Workflow Patterns
Multi-Agent Coordination
  • Specialised Agents
  • Multi-Agent Media Pipelines
  • Multi-Agent Output
  • Agentic Orchestrator Worker
  • Spawn & Announce
  • Multi-Agent Hooks
  • Human-in-the-Loop Review
  • Multi-Agent Execution
  • Multi-Agent Planning
  • Multi-Agent Memory
  • AgentTeam Batch Runs
  • Where Each Option Belongs
  • AgentTeam Re-runs
  • AgentTeam Supported Params
  • AgentTeam Task Validation
  • AgentTeam Task Graph
  • Container Default LLM
  • Handoff Filters
Control Flow & Logic
  • Agentic Routing
  • Conditional Execution
  • Conditional Branching
  • Markdown Workflow Branches
  • Workflow Routing
  • Workflow Validation Loop
  • Typed Workflow State
Execution Patterns
  • Agentic Autonomous Workflow
  • Agentic Parallelisation
  • Workflow Parallel Execution
  • Error Handling
  • Workflow Error Recovery
  • Workflow Error Handling
  • Agentic Prompt Chaining
  • Execution & Extension Systems
Loops & Repetition
  • Repetitive Agents
  • Loop Tasks
  • Workflow Loop Processing
  • Workflow Repeat (Evaluator-Optimizer)
YAML Configuration
  • YAML Workflows
  • Job Workflows
  • YAML Configuration Reference
  • YAML Validation
  • Editor Autocomplete for agents.yaml
  • Workflow YAML Framework Field
Advanced Patterns
  • Agentic Evaluator Optimizer
  • Custom Actions
  • Handler Tasks
  • Output Variables
  • Hybrid Workflows
  • Modular Recipes
  • Nested Workflows
  • Hierarchical Workflows
Evaluation
  • Evaluation Loop
  • Evaluation Suite
  • Run Fingerprint
  • Eval Datasets
  • Loop Evaluator
  • Judge
  • Recipe Judge
  • Grade Your Last Run
  • Context Evaluator
  • Harness Evaluator
  • EvalPort Adapter
  • Safety Evaluation
  • Media Evaluator
  • Goal Engineering
  • Terminal-Bench Integration
Safety & Control
  • Agent Max Budget
  • Subscription Auth
  • Approval
  • Tool Approval
  • API Vocabulary
  • Computer Use Tools
  • Reusable Approval Scopes
  • Approval Backends
  • Secure Approval Backend
  • AgentApproval Prompt-Injection Hardening
  • Durable Approvals
  • Telegram Durable Approval
  • Media Albums
  • Turn Completion Notes
  • Gateway Approval Durability
  • Approval Turn Liveness
  • Outbound Turn Liveness
  • Core Controls
  • Async Tool Safety
  • Tool Call Executor Timeout
  • Concurrency
  • Tool Retry Policy
  • Tool Retry & Backoff
  • Agent Retry
  • OpenAI Client Retries
  • Guardrails
  • Apply Guardrail
  • Per-Tool Guardrails
  • Guardrail Blocked Response
  • Loop Guardrails
  • Non-Fatal Errors
  • Error Handling
  • Structured LLM Errors
  • LLM Error Classification
  • Replay-Safe Retries
  • Task Retry Policy
  • Security Environment Variables
  • .env File Loading
  • Template Security Config
  • Tool Resolver
  • Load Tools From a Python Module
  • Tool Resolution
  • Tool Call Self-Repair
  • Tool Source Registry
  • tools add
  • Tool Discovery Order
  • Local Tools Loading
  • Project-Local Tools
  • Tool Output Store
  • Tool Output Spill
  • Background Shell Execution
  • Compact Tool Output
  • Multi-Agent Context Safety
  • Workspace Isolation
  • Isolated Runs (–worktree)
  • Run in an Isolated Worktree
  • Rules & Instructions
  • Custom Agents, Commands & Tools
  • Agent Presets & Modes
  • Policy Engine
  • Quality Checking
  • Safe Math Eval in Custom Tools
  • Dynamic Judge
  • Task Validation & Feedback
  • Run Outcome
  • Agent Run Outcomes
  • Run Terminal
  • Declarative Permissions
  • Permissions Module
  • Command-Aware Permissions
  • Workspace Boundary
  • Secret File Read Gate
  • Permission Modes
  • MCP SSE Security
  • Interactive Tool Approval
  • Plan Approval Callback
  • Interactive Callback Authorization
  • Escalation Pipeline
  • Loop Guard
  • Loop Detection
  • Escalation Doom-Loop Detection
  • Heartbeat
  • Subagent Delegation
  • Named Subagents
  • Subagent Tool
  • Delegate Task Tool
  • Named Agent Delegation
  • CLI Subagent Delegation
  • Delegation & HITL Limitations
  • Managed Config Layer
  • JOB_COMPLETED Hook
  • Recursive Context
  • Hierarchical Configuration
  • Hierarchical Process
  • Tool Timeouts & Cancellation
  • Cooperative Tool Cancellation
  • Advanced Features Module
  • Approval Protocol
  • Safe Tools by Default
  • Security
Cloud Databases
  • Cloud-Native Serverless Databases
  • Neon Serverless PostgreSQL
  • Supabase Database
  • Turso Edge Database
  • CockroachDB Serverless
  • Xata Serverless Database
State & Sessions
  • Sessions & Remote Agents
  • Session Rename
  • Session Auto-Title
  • Session Forking
  • Project-Scoped Sessions
  • YAML / Team Session Continuity
  • Team Checkpoint & Resume
  • Session Visual Replay
  • Session Model Restore
  • Session Persistence
  • Session Store Protocol
  • Session Hierarchy
  • Session Store
  • Encrypted Session Store
  • Session Mirror
  • SQLite Transcript Store
  • Cross-Session Recall
  • Session Runtime State
  • Stateful Agents
  • Checkpoints
  • Bounded Learning
  • Database Persistence
  • Advanced Memory System
  • Vector Store
  • Prompt Caching
  • Memory Advanced Search
  • Memory Troubleshooting
  • RAG Scoping & Filtering
  • Knowledge Search Results
  • Async Knowledge Retrieval
  • Async Safety
  • Platform Workspace Context
  • Context Compaction
  • Context Compaction Policy
  • Session Handoff
  • Pre-Compaction Memory Flush
  • Compacted Session Resume
  • Context Window Management
  • File Snapshot Module
  • Injected State
  • Context Replay
  • Embed Replay
  • Recipe Workflow
  • Recipe Run History
Context Management
  • Context Strategies & Defaults
  • Context Management
  • Context Manager Module
  • LLM Context Compression
  • Intelligent Conversation Compaction
  • Token Estimation
  • Token Estimation CLI
  • Token Estimation Validation
  • Context Ledger
  • Context Budgeter
  • Context Budgeter CLI
  • Per-Tool Token Budgets
  • Context Optimizer
  • Context Optimizer CLI
  • Prompt Cache Optimization
  • Context Monitor
  • Context Monitor CLI
  • Context Snapshot Hooks
  • Multi-Agent Context Policies
  • Context Observability & History
  • Security & Redaction
  • Dynamic Context Discovery
  • Context Management CLI Reference
  • Context Management API
  • Artifact Storage
  • Chunking Strategies
  • Claude Memory Tool
  • Context Compression
  • Context Management Overview
  • Graph Memory
  • Hierarchical Summaries
  • History Injection
  • Incremental Indexing
  • Knowledge Base
  • Knowledge Backends
  • Knowledge Storage
  • Knowledge Indexing Errors
  • Knowledge Troubleshooting
  • Cloud Storage Sources
  • Custom Knowledge Adapters
  • Large Context Knowledge Handling
  • Quality-Based RAG
  • RAG Quick Start
  • Retrieval Configuration
  • Retrieval Strategies
  • Smart Retrieval
  • Token Budgeting
  • Retrievers & Rerankers in YAML
  • Memory Features
Async & Background
  • Activity Log
  • Async Agents
  • Async Crew Kickoff
  • Async Bridge
  • Async Self-Reflection
  • Async Jobs
  • Jobs agent_file Root
  • Background Tasks
  • Run Ledger
  • Run-State Journal
  • Durable Tool Runs
  • Durable Background Jobs
  • Kanban
  • Kanban CLI
  • Middleware
  • HOL Guard Tool Policy
  • Async Agent Scheduler
  • Background Subagents
LLM & Models
  • Model Catalogue
  • Standalone LLM Modules
  • AutoGen Config List
  • Model Capabilities
  • Model Fallback
  • RouteLLM Integration
  • Panel LLM (Mixture-of-Agents)
  • Configurable Model
  • Rate Limiter
  • LLM Timeouts
  • Reasoning Effort
  • Thinking Budgets
  • Advanced Multi-Provider Patterns
  • Default Model Selection
  • Multi-Model Panel
UI & Display
  • Display System
  • Display Callbacks
  • Output Styles
  • Save Agent Output
  • Headless YAML Runs
  • Generative UI
  • A2UI Protocol
  • Integrate A2UI with Your Frontend
  • Integrating PraisonAI with PraisonAIUI
Integrations
  • LangChain Agents
  • Langflow Integration
  • Works with OpenClaw
  • Load MCP Tools
  • praisonai-mcp Package
  • MCP Memory Tools
  • MCP Todo Tools
  • Recipe → MCP Bridge
  • MCP STDIO Server Transport
  • The Three MCP Layers
  • MCP Tool Filtering
  • MCP Transport Auto-Detection
  • MCP Client Protocol
  • MCP Scoped API Keys
  • MCP YAML Configuration
  • Runtime MCP Management
  • n8n Integration
  • n8n Tools
  • n8n Visual Workflow Editor
  • n8n API Integration
  • A2A Protocol
  • A2A Client
  • A2A Task Management
  • A2A Push Notifications & Async Processing
  • A2A Security
  • Agent Handoffs
  • Handoffs from agents.yaml
  • Handoff Tool Policy
  • Typed Handoffs
  • Runtime Resolution
  • Multi-Agent Patterns
  • Agent Mailbox
  • Agent API Launch
  • Endpoints (Python)
  • Recipe Serve (Python)
  • Recipe Serve Advanced Features
  • AgentOS serve: reload is unsupported
  • Recipe Registry
  • Event Bus Module
  • Durable Event Log
  • Plugins
  • Pure Mode (Suppress Plugins)
  • plugins add
  • Plugin Precedence
  • Framework Adapter Plugins
  • Framework Availability Detection
  • Bot Platform Capabilities
  • Bot Platform Adapter
  • Adapter Capability Contract
  • Bot Platform Plugins
  • Custom Gateway Channel (Zero-Code)
  • Gateway Runtime Contract
  • Bot Session Learning
  • Channel Descriptor
  • Standalone Sender for Custom Channels
  • Registry Dependency Injection
  • Persistence Backend Plugins
  • Integration Registry
  • Model Provider Plugins
  • Custom Provider Adapters
  • Endpoint Provider Registry
  • Web
  • Search Providers
  • Observability Hooks
  • Agent Server Module
  • Agent Profiles Module
  • Microsoft Teams Integration
  • Custom Auth & Pairing Protocols
  • Importing Hermes/OpenClaw Skills
  • ACP – Agent Client Protocol API
  • LangGraph with PraisonAI
  • Final Cut Pro Integration
Capabilities
  • Capabilities Overview
  • Completions
  • Completions CLI
  • Embeddings
  • Embeddings CLI
  • Images
  • Images CLI
  • Videos
  • Videos CLI
  • Messages
  • Messages CLI
  • Moderations
  • Moderations CLI
  • Audio
  • Audio CLI
  • Realtime
  • Realtime CLI
  • Search
  • Vector Store Files
  • Containers
  • Passthrough api_base SSRF Guard
  • Audio Tools
  • Chat with PDF Agents
Embedding Providers
  • Embedding Providers
Cloud Providers
  • OpenAI Embeddings
  • Azure OpenAI Embeddings
  • Azure AI Embeddings
  • Google Vertex AI Embeddings
  • Google Gemini Embeddings
  • AWS Bedrock Embeddings
Specialized Providers
  • Cohere Embeddings
  • Voyage AI Embeddings
  • Jina AI Embeddings
  • Mistral Embeddings
Open Source & Self-Hosted
  • HuggingFace Embeddings
  • Ollama Embeddings
  • Infinity Embeddings
  • vLLM Embeddings
  • LM Studio Embeddings
Additional Providers
  • Together AI Embeddings
  • Fireworks AI Embeddings
  • NVIDIA NIM Embeddings
  • Databricks Embeddings
  • Snowflake Embeddings
  • IBM Watsonx Embeddings
  • SambaNova Embeddings
  • Nebius Embeddings
  • OVHcloud Embeddings
  • Volcengine Embeddings
Advanced Features
  • Command Line Interface
  • Run Stream Events
  • CLI Budget Handling
  • CLI Dispatcher
  • Interactive Resume
  • CLI Help Panels
  • Piped Input
  • Windows Terminal Encoding
  • Windows Setup for PraisonAI Claw
  • Async Agent Scheduler
  • Scheduler Pre-Run Gate
  • Scheduler Monitor
  • Scheduler Monitor Mode
  • Scheduler Incidents
  • Scheduler Misfire Policy
  • Provider-Quota Hold
  • Scheduler Change Detection
  • Scheduler Cross-Run Memory
  • Scheduler Command Action
  • Scheduler Backend Action
  • Scheduler Context Chaining
  • Scheduler Delivery
  • Scheduler Providers
  • Scheduled Run Policy
  • Per-User Scheduler Isolation
  • Scheduler Model Pin
  • Package Tier Architecture
  • praisonai-train Package
  • Reward Functions & GRPO
  • Preference Training
  • Serve trained models
  • Multi-GPU Training
  • Remote GPU training over SSH
  • Send a Run to a GPU Box
  • Continued Pretraining (CPT)
  • Checkpointing, Resume & Best-Checkpoint
  • Dataset Tooling
  • Speed Benchmark
  • Export a trained model
  • Model access, PEFT selectors & offline merge
  • Hub Privacy & Upload Options
  • Vision Fine-Tuning
  • Preference Tuning (DPO / ORPO / KTO)
  • Serve & MTP Fast-Inference
  • List Checkpoints
  • Infer (one-shot inference)
  • Clarify Tool
  • Send Message Tool
  • Send Message Destination Attestation
  • Ask Conversation Tool
  • Gateway Status Tool
  • Tool Availability Gating
  • Multi-tool Agents: HERMES_ONLY_TOOLS
  • Hooks
  • Hook Events
  • Emitting Hook Events
  • BEFORE_TOOL_DEFINITIONS Hook
  • Memory HooksManager
  • Bot Lifecycle Hooks
  • Schedule Lifecycle Hooks
  • Inbound Message Gate
  • Outbound Secret Scrub
  • Secret Egress Sentinels
  • Redact / Block Tool Output
  • Dynamic Variables
  • Variable Substitution
  • AI Agents with Callbacks
  • Task Handlers
  • Agent Skills
  • Skill Automation
  • Remote Skill Sources
  • Skill Bundles
  • Skill Capability Gates
  • Skill Fallback
  • Skills vs Tools
  • Workspace
  • Zep Memory Integration
  • Self-Improving Skills
  • Skill Lifecycle
  • Skill Reload
  • Learn a Skill from Sources
  • Prompt Optimizer
  • Trials Engine
  • Learn Config
  • Self-Improving Agents
  • Learn Skill
  • Bot Default Tools
  • Shell Execution on Bots
  • Todo Planning
  • Live Todo Streaming
  • File Editing
  • Post-Edit Formatter
  • LSP Auto-Detect
  • LSP Navigation Tools
  • Planning Mode
  • Task Context Control
  • Fast Context
  • Profiling
  • AI Code Editing
  • Camera Integration
  • Hosted Agent
  • HostedAgent Compute Runtimes
  • Compute Providers
  • Compute Providers (TypeScript)
  • Self-Hosted Agent (Docker)
  • Managed Backend Plugins
  • Compute Provider Plugins
  • Environment File
  • Environment Capture
  • Local Agent
  • Sandboxed Agent
  • Managed Runtime Protocol
  • Runtime Tool Result Middleware
  • Agent Runtime Protocol
  • Managed Typed Configs
  • Managed Vault
  • Managed Agent Lifecycle
  • HostedAgent + Database Persistence
  • Managed Agent Session Info
  • Tenki Cloud Agents
  • Shared Sandbox
  • Managed CLI
  • Reclaim Stray Sandboxes
  • Telemetry & Performance Tracking
  • Privacy & Data Handling
  • Scripts & Automation
  • TypeScript SDK Dual Build
  • Test
  • Robustness
  • Skill Fallbacks
  • Skill Invocation
  • Custom Tracing
  • Recipe Cycle Testing
  • AI Skill Generator
  • Strong Recipe Prompts
  • Parameter Resolution
Performance & Optimization
  • Lazy Imports & Fast Startup
  • Fast CLI Startup
  • Lite Package (BYO-LLM)
  • Logging Configuration
  • MCP Lifecycle Management
  • MCP CLI Tools Path Safety
  • Performance Benchmarks
  • Thread-Safe Agent State
  • ToolRegistry AutoGen Migration
  • AutoGen Code Execution
  • AutoGen v0.2 YAML Tools
  • Real API Key Testing
  • Offline Testing
Database Persistence
  • Database Persistence
  • Run History
  • SQLite Persistence
  • Hardened SQLite Storage
  • PostgreSQL Persistence
  • MySQL Persistence
  • Redis State Store
  • MongoDB State Store
  • ClickHouse Persistence
  • JSON File Persistence
  • Storage Backends
TUI
  • TUI Overview
  • TUI Commands
  • Queue System
  • TUI Simulation
Deploy Package (praisonai-deploy)
  • Deploy Package
  • Deploy Quick Start
  • Deploy Python API
  • Deploy Config Reference
  • Deploy CLI
  • Custom cloud providers
  • Deploy Doctor
  • Deploy Migration
Models
  • Models in PraisonAI
  • OpenAI ChatGPT
  • OpenAI-Compatible Endpoints
  • Ollama
  • Groq
  • Google Gemini
  • OpenRouter
  • LiteLLM Proxy
  • Anthropic Claude
  • AWS Bedrock
  • Cohere
  • Mistral
  • NVIDIA NIM
  • DeepSeek
  • Together AI
  • Other Models
  • Custom Provider Registry
Databases
  • Databases Overview
Conversation Stores
  • PostgreSQL
  • MySQL
  • SQLite
  • JSON
  • SingleStore
  • Supabase
  • SurrealDB
  • Neon
Knowledge Stores
  • Qdrant
  • ChromaDB
  • Pinecone
  • Weaviate
  • LanceDB
  • Milvus
  • PGVector
  • Cassandra
  • ClickHouse
  • Couchbase
  • Azure Cosmos DB
  • MongoDB Knowledge
State Stores
  • Redis
  • MongoDB
  • DynamoDB
  • Firestore
  • Upstash
  • Google Cloud Storage
Observability
  • Observability Overview
  • Performance Profiling
  • AgentOps
  • Langextract
  • Langfuse
  • LangSmith
  • Traceloop
  • Arize Phoenix
  • OpenLIT
  • Langtrace
  • LangWatch
  • Datadog
  • MLflow
  • Opik
  • Portkey
  • Braintrust
  • Maxim
  • Weave
  • Neatlogs
  • LangDB
  • Atla
  • Patronus
  • TrueFoundry
  • AgentOps PraisonAI Monitoring
  • Latency Tracking
Memory
  • Memory Overview
  • Memory Storage
  • Quickstart
  • Session Resume
  • Advanced Memory System
  • Graph Memory
  • Memory Advanced Search
  • Memory Lifecycle Hooks
  • Memory Consolidation
  • Custom Memory Adapters
  • MongoDB Memory
  • Local Memory & Knowledge
  • Dakera Memory
Telemetry & Analytics
  • Token Usage Protocol
  • Durable Token Usage Sink (SQLite)
  • Usage Reporting
Knowledge
  • Knowledge Overview
  • Knowledge Quick Start
  • Knowledge Storage
  • Knowledge Erasure
  • Knowledge Base
  • Knowledge Backends
  • Chat with PDF Agents
RAG
  • RAG Overview
  • RAG Quickstart
  • RAG Quick Start
  • Retrieval Configuration
  • Quality-Based RAG Patterns
  • RAG Module
  • Citations
  • RAG CLI
Chunking Strategies
  • Chunking Strategies Overview
  • Token Chunking
  • Sentence Chunking
  • Recursive Chunking
  • Semantic Chunking
  • SDPM Chunking
  • Late Chunking
Web Scraping
  • Firecrawl PraisonAI Integration
Task Management
  • Linear Tools
Other Features
  • PraisonAI Train
  • Praison AI Agents Playground
  • CrewAI with PraisonAI
  • AutoGen with PraisonAI
  • PraisonAI Agents
  • Google ADK with PraisonAI
  • Agno with PraisonAI
  • Pydantic AI with PraisonAI
  • OpenAI Agents with PraisonAI
  • API Reference
  • API Reference
  • API Reference
  • Workflow API
  • PraisonAI Call
  • Praison AI
  • Features Overview
API Reference
  • Simplified API Reference
  • praisonaiagents API
A2A Endpoints
  • A2A API
  • GET Agent Card API
  • GET Status API
  • POST A2A API
  • A2A Architecture
AGUI Endpoints
  • AG-UI API
  • GET /status
  • POST /agui API
Launch Endpoints
  • Agent Launch API
  • POST Agent Endpoint API
MCP Endpoints
  • MCP Server API
  • GET /sse API
  • POST Messages API
Developers
  • Complete Reference
  • Testing Guide
  • Pytest Failure Categories
  • Agents Playbook
  • PraisonAI Package Integration
  • Integrate with Tools
  • Google Colab Integration
  • Google Colab Tools
  • Local Development
  • Development Setup
  • Benchmarks
  • Production Deployment Guide
  • Testing Agents Guide
  • Advanced Tool Development
  • Contributing
  • Video Tutorials
SDK Internals
  • Core Principles
  • SDK Architecture
Configuration
  • Configuration Reference
  • Agent Configuration
  • Task Configuration
  • LLM Configuration
  • Memory Configuration
  • LearnConfig
  • KnowledgeConfig
  • PlanningConfig
  • ReflectionConfig
  • WebConfig
  • OutputConfig
  • ExecutionConfig
  • TemplateConfig
  • CachingConfig
  • HooksConfig
  • SkillsConfig
  • AutonomyConfig
  • Tool Configuration
  • Guardrail Configuration
  • Handoff Configuration
  • Configuration Best Practices
Best Practices
  • Error Handling in Multi-Agent Systems
  • Debugging Multi-Agent Systems
  • Performance Tuning Guidelines
  • Security Best Practices
  • Token Usage Optimization
  • Memory Cleanup for Long-Running Apps
  • Agent Retry Strategies
  • Graceful Degradation Patterns
  • Multi-User Session Handling
  • State Conflict Resolution
  • Task Orchestration Best Practices
Getting Started (No Code)
  • Introduction
  • TL;DR
  • Installation
  • Initialise
  • Run
  • Auto Generation Mode
Docs/Getting Started/Advanced Features/Test
PreviousNext

Test

Instructions for running and writing tests for PraisonAI components, including unit tests and test automation

Test

bash
python -m unittest tests.test 
PreviousNext
  • Platform
  • Use Cases
  • Agents
  • Bot
  • Enterprise
  • Partners
  • Community
  • FAQ
  • About
  • University
  • Documentation
  • GitHub

© Praison AI Limited.

Search in