Skip to main content
The praisonai dashboard command launches a unified interface that auto-starts Flow Builder, Claw, and Chat UI — one command to open all PraisonAI services.

​
Quick Start

1

One-command launch

Launch all services with a single command that auto-opens port 3000 and starts Flow, Claw, and Chat UI:
praisonai dashboard
This starts the unified dashboard on port 3000 and automatically launches all three services.
2

Standalone dashboard only

Use when services are already running or you want to manage them manually:
praisonai dashboard --no-auto-start
This launches only the dashboard interface without starting the backend services.
3

Experimental enhanced UI

Try the enhanced dashboard interface with additional features:
praisonai dashboard --aiui
Requires pip install aiui. Falls back gracefully to standard dashboard if not installed.

​
How It Works

The dashboard follows this process:
PhaseDescription
SpawnLaunches Flow (7860), Claw (8082), and UI (8081) services
ReadinessPolls each service for up to 15 seconds until ports accept connections
DashboardStarts unified FastAPI interface linking to all services
CleanupGracefully terminates child services on exit

​
Configuration Options

OptionTypeDefaultDescription
--port, -pint3000Port to run the unified dashboard on
--hoststr127.0.0.1Host to bind to (use 0.0.0.0 to expose remotely)
--auto-start / --no-auto-startboolTrueAuto-start Flow, Claw, and UI services before opening dashboard
--aiuiboolFalseUse enhanced dashboard interface (experimental; requires aiui package)

​
Ports Used

ServiceDefault PortStarted by
Unified Dashboard3000praisonai dashboard
Flow Builder7860Auto-started (praisonai flow --no-open)
Claw Dashboard8082Auto-started (praisonai claw)
Chat UI8081Auto-started (praisonai ui)

​
Log Files

Per-service logs are written to: 
~/.praisonai/unified/logs/flow.log
~/.praisonai/unified/logs/claw.log
~/.praisonai/unified/logs/ui.log

​
Common Patterns

​
Expose dashboard on LAN

praisonai dashboard --host 0.0.0.0 --port 9000

​
Attach to existing services

praisonai dashboard --no-auto-start
Use when Flow, Claw, and UI are already running and you only want the unified interface.

​
Try experimental aiui interface

# First install the package
pip install aiui

# Then launch with enhanced UI
praisonai dashboard --aiui

​
Troubleshoot failed auto-start

Check service logs if a service fails to start: 
# Check individual service logs
tail -f ~/.praisonai/unified/logs/flow.log
tail -f ~/.praisonai/unified/logs/claw.log
tail -f ~/.praisonai/unified/logs/ui.log

​
Which Option Should I Use?

​
Best Practices

Use praisonai dashboard as your standard command for local development. It’s designed to feel like launching a single application while giving you access to all PraisonAI interfaces.
In CI, Docker, or other managed environments where services are started separately, use --no-auto-start to launch only the dashboard interface.
The --aiui flag provides enhanced features but requires the separate aiui package. It gracefully falls back to the standard dashboard if the package is missing, but treat it as experimental for production use.
Before concluding there’s a port conflict, check the per-service logs in ~/.praisonai/unified/logs/ to see the actual error messages from failed services.

Claw Dashboard

Full administrative dashboard for managing agents, tools, and channels

Flow Builder

Visual workflow designer with drag-and-drop interface

Chat UI

Clean, distraction-free chat interface

Unified Server

Different feature: HTTP API server (not the desktop launcher)