CLI
Python - Single Agent
Python - Multi-Agent
agents.yaml
CLI Flags
| Flag | Default | Description |
|---|---|---|
--serve | - | Start API server |
--port | 8005 | Server port |
--host | 127.0.0.1 | Server host |
launch() Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
path | str | / | API endpoint path |
port | int | 8000 | Server port |
host | str | 0.0.0.0 | Server host |
debug | bool | False | Debug mode |
protocol | str | http | http or mcp |
Endpoints
| Endpoint | Method | Description |
|---|---|---|
/{path} | POST | Send query to agent(s) |
/{path}/list | GET | List available agents |
/{path}/{agent_id} | POST | Call specific agent |
/health | GET | Health check |
/docs | GET | Swagger UI |
Troubleshooting
| Issue | Fix |
|---|---|
| Port in use | lsof -i :8000 then kill process |
| No agents.yaml | python -m praisonai --init "topic" |
| Missing API key | export OPENAI_API_KEY="your-key" |
| Missing deps | pip install "praisonaiagents[api]" |
Related
- Agents API Reference - Full API documentation
- MCP Server - Deploy as MCP server
- Docker - Deploy to Docker

