Metadata-Version: 2.4
Name: kelam
Version: 0.1.2
Summary: Build and run voice AI agents from the terminal — the Kelam CLI.
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: kelam-core>=0.1.0
Requires-Dist: httpx<1,>=0.27
Requires-Dist: typer<1,>=0.12

# 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

```sh
curl -fsSL https://kelam.sh | sh        # one-command installer
# or:
uv tool install kelam
pipx install kelam
```

## Configure

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

## The loop

```sh
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.
