kelam 0.8.1

Build and run voice AI agents from the terminal — the Kelam CLI.

kelam

Build and run voice AI agents from the terminal — the Kelam CLI.

A thin, dependency-light client (httpx + typer + the shared kelam-core contract) for the Kelam voice-agent control plane. Create agents, deploy them, place real phone calls, talk to them in the browser, send texts, and export call data — all from kelam.

Install

curl -fsSL https://kelam.sh | sh        # one-command installer (picks brew/uv/pipx)
# or directly:
brew install samsadsam/kelam/kelam
uv tool install kelam
pipx install kelam

Re-running the installer is safe — it detects an existing install and does nothing.

Check the version / upgrade

kelam --version      # what's installed
kelam update         # upgrade in place (detects uv / pipx / Homebrew automatically)

Configure

export KELAM_API_URL=https://<your-kelam-host>
export KELAM_PASSWORD=<password>        # only if the server uses shared-password auth
kelam list

The loop

kelam create my-bot              # scaffold + provision a phone number
kelam deploy <agent_id>          # assemble + cache the runtime
kelam call   <agent_id> +1206... # place a real outbound call
kelam web    <agent_id>          # or talk in the browser, no phone number
kelam export --since 7d          # call logs + derived metrics

The platform (API + voice worker) lives in the separate kelam-backend package; this package is just the operator CLI.