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)

Searching Database…

145 ·GitHub
Что это такое?Egma — это опенсорс-платформа для тестирования голосовых агентов перед выпуском и мониторинга их в продакшене: наборы регрессионных симуляций плюс живая аналитика реальных разговоров.
Это облачный сервис или хостить самому?И то и другое: можно использовать облачный Egma Cloud или развернуть его на своей машине и открыть в браузере. Ваши тестовые наборы лежат в репозитории самого агента и запускаются через Egma CLI или кодинг-агент.
Как запустить первый тест?Откройте репозиторий вашего голосового агента в кодинг-агенте и вставьте промпт для настройки из README — первая симуляция занимает около пяти минут. Если хотите развернуть у себя, настройте .env, запустите Egma и создайте аккаунт на localhost:3101.
С какими платформами голосовых агентов он работает?Сейчас поддерживаются только агенты на базе LiveKit (JS/TS) или Retell; другие платформы можно запросить в Discord. API-ключи провайдера моделей вы также подключаете свои.
Чего он пока не умеет?Самостоятельное развёртывание требует дополнительного времени на установку и первую сборку, а автоматические исправления пока существуют только в планах — сегодня Egma занимается только тестированием и мониторингом в продакшене.
Сколько стоит Egma и под какой лицензией он распространяется?Репозиторий распространяется по лицензии MIT, кроме папок ee, а самостоятельное развёртывание бесплатно; за использование моделей вы платите провайдерам напрямую, без наценки Egma.
Что именно симулирует тест в Egma?Наборы симулированных голосовых и текстовых разговоров с заглушками вместо ответов инструментов (mocked tool responses). Можно настраивать персоны звонящих, выбирать используемые модели, а также задавать инструкции для оценки и пороги прохождения для того поведения, которое вы хотите проверить.
Он тестирует только голос или и текстовых агентов тоже?И то и другое: регрессионные наборы смешивают симулированные голосовые и текстовые разговоры, так что текстовые агенты получают то же отношение, что и голосовые.
Что мне показывает мониторинг в продакшене?Реальные разговоры, вызовы инструментов и метрики из живого трафика. Градеры проверяют поведение вашего агента, чтобы вы могли разбираться в сбоях.
Что есть в планах?Автоматические исправления: Egma планирует брать сбой из продакшена, предлагать изменение в обвязке вашего голосового агента, тестировать его и открывать pull request на ваше рассмотрение.
Creator
egma-ai
Size
35.2 MB
Stars
145
Age
2mo
Commits · 90 Days