egma README

The project's README from github.com/egma-ai/egma. As one markdown file: README.md.

Egma

Egma is an open-source platform for testing voice agents and monitoring them in production.

Docs · Egma Cloud · Discord

🧩 Core features

Egma supports LiveKit (JS/TS) and Retell. Contact us on Discord to request another platform or feature.

🚀 Get started

Run your first voice simulation in as little as five minutes.

Open your voice agent's repository in your coding agent and paste:

Set up Egma in this repo. Install its skills with
npx skills add egma-ai/egma, then use them to connect
my voice agent and run my first voice simulation.

For Egma Cloud, create an account and use the prompt above. To self-host, follow the self-hosting guide and include your instance's URL in the prompt. Allow extra time for installation and the first build.

🖥️ Self-hosting

Run Egma on your own machine

git clone https://github.com/egma-ai/egma.git
cd egma
npm install --global egma-cli
cp .env.example .env
chmod 600 .env

Configure .env using the self-hosting guide, then start Egma:

egma self-host up

Open localhost:3101 and create your account. See the self-hosting guide for connecting your agent, server setup, and troubleshooting.

🧭 Where we're headed

Egma supports testing and production monitoring today. We plan to add automatic fixes: Egma would use a production failure to propose a change to your voice agent's harness, test it, and open a pull request for you to review.

💬 Help and feedback

Read the docs

Join Discord

Open a GitHub issue

⚖️ License

This repository is MIT licensed, except for the ee folders. See LICENSE for more details.

egma (egma-ai/egma)

agent-observability
Searching Database…

145 ·GitHub
What is this?Egma is an open-source platform for testing voice agents before you ship them and monitoring them in production — simulated regression suites plus live analytics of real conversations.
Is this a cloud service or something I host myself?Either: use hosted Egma Cloud or self-host it on your own machine and open it in the browser. Your test suites live in the agent's own repository and run through the Egma CLI or a coding agent.
How do I run my first test?Open your voice agent's repo in your coding agent and paste the setup prompt from the README — the first simulation takes about five minutes. To self-host instead, configure .env, start Egma and create your account at localhost:3101.
Which voice agent platforms does it work with?Right now only agents built on LiveKit (JS/TS) or Retell are supported; other platforms can be requested on Discord. You also plug in your own model-provider API keys.
What can't it do yet?Self-hosting takes extra time for installation and the first build, and automatic fixes are still just a roadmap idea — today Egma covers testing and production monitoring only.
What does Egma cost, and how is it licensed?The repository is MIT-licensed except for the ee folders, and self-hosting is free; on model usage you pay providers directly, with no Egma markup.
What does an Egma test actually simulate?Suites of simulated voice and text conversations with mocked tool responses. You can customize caller personas, pick the models used, and set grading instructions and pass thresholds for the behavior you want to verify.
Does it only test voice, or text agents too?Both: regression suites mix simulated voice and text conversations, so text-based agents get the same treatment as voice ones.
What does production monitoring show me?Real conversations, tool calls and metrics from live traffic. Graders check your agent's behavior so you can investigate failures.
What's on the roadmap?Automatic fixes: Egma plans to take a production failure, propose a change to your voice agent's harness, test it, and open a pull request for you to review.
Creator
egma-ai
Size
35.2 MB
Stars
145
Age
2mo
Commits · 90 Days