Skip to main content
Egma is the open-source platform purpose-built for teams shipping voice agents. It lets you simulate real conversations before they reach production, monitor live calls through OpenTelemetry, and automatically grade every exchange against the behaviors you expect — so you ship with confidence rather than guesswork.

Introduction

Learn what Egma is, how it works, and which platforms it integrates with.

Quickstart

Run your first simulation test in minutes using the Egma CLI wizard.

CLI Reference

Every command, option, and exit code the Egma CLI exposes.

API Reference

REST endpoints for traces, runs, verdicts, and platform configuration.

​
Get up and running

1

Install the CLI

Run the Egma wizard from your voice agent’s repository. No global install required — npx handles it.
2

Connect your agent

Egma signs this machine in with a short browser approval, then asks for your Retell or LiveKit credentials to register your agent. Your key is sent once, sealed on the platform, and never written to a file.
3

Write tests

The wizard drives your existing coding agent to read your repository and generate a first suite of test files in egma/tests/. Each test describes a scenario and the behaviors your agent should demonstrate.
4

Run tests

Push your tests to Egma and start a run. The simulator conducts real conversations with your agent; the grader writes one verdict per expected behavior as each call finishes.

​
Key integrations

Retell

Test Retell voice agents over text or phone, with your live prompt and tools.

Python SDK

Install the Egma SDK in your LiveKit agent to handle tool mocking during simulations.