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 收费吗?采用什么开源协议?除了 ee 文件夹之外,仓库采用 MIT 协议,自托管免费;模型使用费用直接付给各提供商,Egma 不加价。
Egma 的测试具体模拟什么?模拟语音和文字对话的测试套件,并使用模拟的工具响应。你可以自定义来电者人设、选择使用的模型,还可以设置评分指令和通过阈值,来验证你想要的行为。
它只测试语音,还是也支持文字智能体?两者都支持:回归测试套件会把模拟的语音对话和文字对话混合在一起,所以文字智能体能得到和语音智能体同等的测试。
生产环境监控能看到什么?来自真实流量的实际对话、工具调用和各项指标。评分器会检查智能体的行为,方便你排查失败的原因。
路线图上有什么计划?自动修复:Egma 计划在出现生产故障后,为你的语音智能体的运行框架提出修改建议,进行测试,然后开一个 pull request 供你审阅。
Creator
egma-ai
Size
35.2 MB
Stars
145
Age
2mo
Commits · 90 Days