Call

Voice and call interaction mode

The call command starts the PraisonAI Call server for voice-based AI interactions over phone calls.

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

praisonai call [OPTIONS]

Options

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
--port	Port to run the server on	8090 (or PORT env var)
--host	Host to bind the server to	127.0.0.1
--public	Expose 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.

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).

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. See PraisonAI Call.

Examples

Start locally (default)

praisonai call

Custom port

praisonai call --port 8090

Expose publicly via ngrok

export NGROK_AUTH_TOKEN="your-ngrok-auth-token"
praisonai call --public

--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

praisonai call --host 0.0.0.0 --port 8090

See Also

• PraisonAI Call - Full setup guide with Docker, tools, and deployment
• Voice Call API - HTTP endpoints reference
• Realtime - Realtime interaction mode