eggent-ai/eggent

Eggent – 本地优先的 AI 工作区

它是什么 – Eggent 是一个基于浏览器的自托管应用，可运行与各个项目绑定的 LLM 支持的“代理”。每个项目都有自己的提示词、文件、记忆、技能、模型设置，并可通过管道一起编排。用户界面将所有内容存储在本地 data/ 文件夹中，因此您可以完全控制自己的数据。

主要功能

• 项目范围代理 – 每个项目可分别设置指令、文件、记忆和模型覆盖。
• 本地优先存储 – 所有数据都存放在 data/ 下，可像其他文件一样备份。
• 带上下文的聊天界面 – 上传文件或粘贴截图；代理会将其视为可读路径。
• 管道 – 将多个项目代理链式连接，将工件从一个步骤传递到下一个步骤。
• 外部 HTTP API – 发送消息、保持会话状态（项目、聊天、路径）并接收最终回复。适用于机器人、CRM、后端等。
• Telegram 集成 – 机器人可将消息（包括语音）转发给 Eggent；语音通过 whisper.cpp 在本地转录。
• 本地语音转录 – 无需外部语音转文本服务；通过 whisper.cpp 在设备上运行。
• Docker 就绪 – GitHub Container Registry 上的官方镜像，简单的 docker compose 部署，可选的 .env 覆盖。
• 模型与技能可扩展 – 按项目的模型 JSON、MCP 配置以及基于文件夹的技能系统。

如何开始

1. 使用一条 curl 命令安装（curl -fsSL https://get.eggent.ai | bash）。它会克隆仓库、构建 Docker 镜像并启动容器。
2. 打开 http://127.0.0.1:3000，登录，并通过界面添加 LLM 提供商密钥（无需编辑 .env）。
3. 创建项目，上传文件，开始与代理聊天。
4. （可选）通过提供 TELEGRAM_BOT_TOKEN 和 webhook 设置启用 Telegram 机器人。
5. 如需以编程方式使用，请在 设置 → API 中生成外部 API 令牌，并使用 sessionId 和 message 调用 POST /api/external/message。

典型使用案例

• 记住过往工单（项目记忆）的客户支持助手。
• 研究到写作的工作流程：一个“研究”代理收集资料，另一个“写作”代理通过管道起草报告。
• 内部工具：通过外部 API 将 Eggent 连接到 CRM 或工单系统。
• 个人知识库：存储笔记、PDF，让代理进行总结。

限制 / 注意事项

• 外部 API 仅返回最终回复；不支持流式响应。
• 定时任务仅在 Eggent 进程运行时执行；重启后尚未持久化。
• 拒绝超过 100 MB 的文件上传；大文件夹会被拆分为多个请求。
• 默认情况下服务器绑定到 127.0.0.1；生产环境请通过反向代理暴露。

适合谁 – 希望拥有自托管、面向项目的 LLM 工作区，并具备易用 UI、文件处理能力和集成点，而不依赖纯云 SaaS 解决方案的开发者或团队。