Kelam

Build and run voice AI agents from the terminal.

Kelam is a CLI + small platform for voice AI agents that make and answer real phone calls. You describe an agent as a few files, push it, and call a phone number — or talk to it in your browser. Under the hood a call runs a Deepgram → Claude → ElevenLabs conversation over a phone line, with the transcript and recording saved for you.

kelam create booking-bot           # scaffold an agent (+ provision a number)
kelam deploy booking-bot           # make it callable
kelam call   booking-bot +1206...  # place a real outbound call
kelam web    booking-bot           # …or talk to it in the browser, no phone number

What it does

• 📞 Phone calls — outbound and inbound, over a real phone number.
• 🌐 Browser calls — talk to an agent over WebRTC with no phone number at all.
• 💬 Texting — send SMS/MMS from the agent's number; threads are stored and replyable.
• 🧩 Agents as files — agent.yaml + scenarios/*.md + tools/*.py, edited locally and pushed git-style (every push is a new version).
• 📊 Call data — kelam export / kelam stats give transcripts plus derived metrics (turns, words, talk ratio, durations) ready to chart.

Install the CLI

One command:

curl -fsSL https://kelam.sh | sh

Or with your own tooling:

uv tool install kelam
pipx install kelam

Then point it at your Kelam server and (if it uses shared-password auth) authenticate:

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

The CLI is a thin client — it talks to a Kelam server (the control plane + voice worker). Bring your own deployment, or ask the maintainers for access.

Install the Claude Code plugin

Use Kelam straight from Claude Code — the NousData marketplace ships a kelam plugin:

/plugin marketplace add nousdata/plugins
/plugin install kelam@nousdata

It includes:

• kelam-setup — just tell Claude "please setup kelam.sh for me" and it installs and configures the CLI for you (also /kelam:setup).
• kelam-viz — turns kelam export / kelam stats output into self-contained HTML dashboards (transcripts, call volume, durations, talk ratio).

The full loop

kelam create my-bot                       # scaffold + provision
# edit my-bot/agent.yaml, scenarios/*.md, tools/*.py
kelam verify my-bot --src ./my-bot        # lint
kelam push   my-bot --src ./my-bot        # new version
kelam deploy my-bot                       # ready for calls
kelam call   my-bot +1206... -p "extract their email and timeline"
kelam transcript <call_id>                # status + transcript + recording
kelam export --since 7d | ...             # call logs + metrics -> kelam-viz

License

MIT — see LICENSE.