Docs / CLI / Interactive Features / Call Call Voice and call interaction mode
The call command starts the PraisonAI Call server for voice-based AI interactions over phone calls.
Info Install requirement: praisonai call requires pip install praisonai (the full wrapper). On a standalone pip install praisonai-code install every call subcommand exits 1 with call requires the full wrapper. Install the full wrapper: pip install praisonai — a single-line hint, no Rich traceback (PR #2854 ).
Usage
bash praisonai call [OPTIONS]
Options
Note In older praisonai versions, --public / --port / --host were reachable only through the PUBLIC / PORT / HOST environment variables. From the release that includes PR #4927 they are proper CLI flags on praisonai call.
Option Description Default --portPort to run the server on 8090 (or PORT env var)--hostHost to bind the server to 127.0.0.1--publicExpose the server via an ngrok tunnel false
When --port is omitted, the call server picks its own default ($PORT if set, else 8090) — unrelated argparse defaults elsewhere in the CLI are not forwarded.
Note praisonai call binds to 127.0.0.1 by default — local machine access only. To expose on your LAN, pass --host 0.0.0.0 (a warning will print). To expose publicly, use --public (requires NGROK_AUTH_TOKEN).
Note The praisonai call CLI loads .env explicitly at run time. Importing praisonai.api.call no longer loads .env at import time — set PRAISONAI_CALL_LOAD_DOTENV=true to restore the legacy import-time behaviour. .env is discovered from the current working directory, not from the package install location — see .env File Loading . See PraisonAI Call .
Examples
Start locally (default)
bash praisonai call
Custom port
bash praisonai call --port 8090
Expose publicly via ngrok
bash export NGROK_AUTH_TOKEN="your-ngrok-auth-token"
praisonai call --public
Warning --public forces a 0.0.0.0 bind and refuses the PRAISONAI_CALL_AUTH=disabled escape hatch — a public tunnel always requires auth. See Security for depth.
Expose on LAN
bash praisonai call --host 0.0.0.0 --port 8090
See Also