Quick Start
Features
Multi-Agent Support
Seamlessly interact with multiple AI agents in a single interface
Tool Visualization
See agent tool calls and their results in real-time
Streaming Responses
Real-time streaming of agent responses
Session Management
Persistent sessions with full history
Multi-Agent Chat
Configuration
ChatConfig Options
Environment Variables
| Variable | Description | Default |
|---|---|---|
PRAISONAI_CHAT_PORT | Server port | 8000 |
PRAISONAI_CHAT_HOST | Server host | 0.0.0.0 |
CHAINLIT_HOST | Host the UI binds to (drives auth mode) | 127.0.0.1 |
CHAINLIT_USERNAME | Username for authentication | admin |
CHAINLIT_PASSWORD | Password for authentication | admin |
PRAISONAI_ALLOW_DEFAULT_CREDS | Allow admin/admin on external bind (unsafe) | false |
CHAINLIT_AUTH_SECRET | Auth secret for sessions | Auto-generated |
Security
The chat UI enforces bind-aware authentication — stricter security when bound to external interfaces.| Interface | Security Mode | Credentials |
|---|---|---|
Loopback (127.0.0.1, localhost) | Permissive | admin/admin allowed |
External (0.0.0.0, LAN, public) | Strict | Custom credentials required |
Bind-Aware Authentication
Complete security configuration guide
UI Features
Chain of Thought Visualization
The chat interface displays agent reasoning steps, showing how agents arrive at their responses.Tool Call Panel
When agents use tools, the UI displays:- Tool name
- Input arguments
- Tool output/results
- Execution time
Session History
- Automatic session persistence
- Resume previous conversations
- Export chat history
Integration with PraisonAI Agents
PraisonAI Chat integrates seamlessly with the full PraisonAI agent framework:Upstream Updates
PraisonAI Chat is based on Chainlit, an excellent open-source framework. We maintain compatibility with upstream updates. To sync with upstream improvements:How It Works
Best Practices
Start with a single agent
Start with a single agent
Validate prompts and tools in chat before adding multi-agent complexity. One well-instructed agent is easier to debug than a team.
Enable streaming for long replies
Enable streaming for long replies
Use streaming so users see progress during tool calls and multi-step reasoning instead of waiting for a full response.
Persist sessions in production
Persist sessions in production
Configure session storage when users return across visits. Ephemeral sessions are fine for local dev only.
Pin the chat extra version
Pin the chat extra version
Install
praisonai[chat] in CI and production with a pinned version so the UI and SDK stay compatible.License
PraisonAI Chat is licensed under the Apache 2.0 License. See THIRD_PARTY_NOTICES.md for attribution.Related
Chat with your documents by grounding replies in PDF content.
Persist conversation history so users can resume chats across visits.

