praisonai doctor command provides comprehensive health checks and diagnostics for your PraisonAI installation, configuration, and environment.
Quick Start
Subcommands
| Subcommand | Description |
|---|---|
env | Check environment variables and system configuration |
config | Validate configuration files (agents.yaml, workflow.yaml) |
tools | Check tool availability and dependencies |
db | Check database drivers and connectivity |
mcp | Check MCP server configuration |
obs | Check observability providers (Langfuse, LangSmith, etc.) |
skills | Check agent skills directories |
memory | Check memory storage and sessions |
permissions | Check filesystem permissions |
network | Check network connectivity and proxy settings |
performance | Check import times and module counts |
ci | CI-optimized checks with JSON output |
selftest | Test agent creation and chat functionality |
Global Flags
| Flag | Description |
|---|---|
--json | Output in JSON format |
--format text|json | Output format (default: text) |
--output PATH | Write report to file |
--deep | Enable deeper probes (DB connects, network checks) |
--timeout SEC | Per-check timeout in seconds (default: 10) |
--strict | Treat warnings as failures |
--quiet | Minimal output |
--no-color | Disable ANSI colors |
--only IDS | Only run these check IDs (comma-separated) |
--skip IDS | Skip these check IDs (comma-separated) |
--list-checks | List available check IDs |
--version | Show doctor module version |
Exit Codes
Root Command
| Code | Meaning |
|---|---|
| 0 | All checks passed |
| 1 | One or more checks failed (or warnings in strict mode) |
| 2 | Internal error |
CI Mode
| Code | Meaning |
|---|---|
| 0 | All checks passed |
| 1 | One or more checks failed |
| 2 | Timeout |
| 3 | Internal error |
Examples
Environment Checks
Configuration Validation
Database Checks
MCP Server Checks
Performance Analysis
Self-Test
CI Integration
Filtering Checks
JSON Output Format
Check Categories
Environment (env)
- Python version validation
- Package installation checks
- API key configuration
- OS and architecture info
- Virtual environment detection
- Binary availability (git, docker, npx)
Configuration (config)
- agents.yaml existence and syntax
- workflow.yaml validation
- .praison config directory
- .env file detection
Tools (tools)
- Tool registry access
- Web search tools
- File operation tools
- Code execution tools
- API key requirements
Database (db)
- Driver availability (PostgreSQL, SQLite, Redis, MongoDB)
- ChromaDB for RAG
- Connection testing (deep mode)
MCP (mcp)
- Configuration file validation
- npx availability
- Python MCP package
- Server configuration validation
- Server spawn testing (deep mode)
Observability (obs)
- Langfuse configuration
- LangSmith configuration
- AgentOps configuration
- PraisonAI telemetry
Skills (skills)
- Skills directory discovery
- SKILL.md validation
- PraisonAI skills module
Memory (memory)
- Memory directories
- JSON file integrity
- Session storage
- ChromaDB vector memory
Permissions (permissions)
- ~/.praison directory
- Project .praison directory
- Temp directory
- Current working directory
- Config directory
Network (network)
- DNS resolution (deep mode)
- HTTPS connectivity (deep mode)
- Proxy configuration
- SSL/TLS settings
- OpenAI base URL
Performance (performance)
- Package import times
- Slow import detection (deep mode)
- Loaded module count
Self-Test (selftest)
- Agent import
- Agent instantiation
- LLM configuration
- Mock/live chat testing
- Tools wiring

