Skip to content

Latest commit

 

History

History
208 lines (148 loc) · 10.1 KB

File metadata and controls

208 lines (148 loc) · 10.1 KB

EMRG

EMRG

一个会写代码的 AI 编程助手——而且它还会重写自己

Python License Status Tests PRs Welcome

🇬🇧 English | 🇨🇳 中文


如果每次使用,你的编程助手都在变得更好,会怎样?

EMRG 是一个关于自主进化的实验:一个能帮你写代码的 AI 智能体——读文件、跑命令、做编辑——而你的每一条吐槽 (/rant) 都会驱动它自我改进。你说它哪里不好,下一个演化周期它就自己写代码修好并上线。完全开源,完全透明。

"EMRG 是一个自我进化的 AI 智能体架构实验。"MANIFESTO

人人都是产品经理——你的每一条吐槽,都是下一版的需求单。 人人都是硅基生命的宿主——你运行的,是一个与你共生进化的数字生命。

EMRG(读作 emerge,涌现)——智能涌现:能力在规模与使用中涌现。字母展开:Evolving Micro-kernel, Rant-driven Growth(演化的微内核,吐槽驱动的成长)。


为什么你会爱上它

一句话定位:EMRG 是唯一一个会因你的反馈而自我改进的编程智能体——吐槽哪里不好,下一个演化周期它就自己写代码修好并上线。

唯一核心卖点:自我改进。 每一条 /rant 都会变成真实的 PR——分析、编码、测试、合并,全程无人值守。没有其他编程智能体做得到。

特性 差异点
Electron GUI(主入口) 安装即用:首次启动引导配置 API Key;全部 / 指令可用;结果面板、Ask/Auto 模式、自进化可见化。GUI 配好即 TUI 可用
全功能 TUI + 守护进程 流式 Markdown、/ 自动补全、会话管理、快捷键——跑在常驻的 emrgd 守护进程上,随时重连
定时任务 内置 + 自定义任务类型(提示词模板存 ~/.emrg/task-templates/)、GUI 设置页增删改 + 热加载、/trigger 随时手动触发
100% 开源 MIT 协议——没有围墙,没有厂商锁定。默认英文,提供中文版

吐槽驱动演化(核心特色)

EMRG 不只是一个工具——它是一个会听吐槽、会自我改进的编程伙伴:

输入:
  - 你的吐槽 (/rant)   <- 最主要的输入
  - GitHub Issues & PRs
  - 竞品动态 (Codex, Claude Code)
  - 跨项目学习
          |
          v
演化循环(每 30 分钟)
(准备 -> 回顾 -> 发现 -> 改进 -> 提交 -> 记录)
          |
          v
  1. pytest + import 检查
  2. git commit + push -> PR
  3. 演化日志

真实案例:有人吐槽 "TUI 需要像 Codex 那样的 / 自动补全"。下一个演化周期,EMRG 自己实现了——完整的前缀过滤和方向键导航,合并、部署、搞定。你对它吐槽什么,它就改进什么。

如何贡献? 使用它。在设置里连接 GitHub,然后吐槽。你的吐槽会变成真实的 PR——演化周期负责编码、测试、上线。不需要 fork、clone、写代码。使用 EMRG,就是在为 EMRG 做贡献。


快速开始

下载安装包(推荐)

GitHub Releases 下载对应平台的安装文件,双击安装即可——安装包内置完整运行时(Python 3.13 + git + gh + GUI),零前置依赖,离线安装

平台 安装文件
macOS EMRG-<ver>-macos-arm64.pkg / -x64.pkg(用户级安装,无需管理员密码)
Windows EMRG-<ver>-windows-x64.exe(免 UAC,PATH 自动注册)
Linux EMRG-<ver>-linux-x86_64.run / -aarch64.run(无头服务器,一条命令)· -x86_64.AppImage / -aarch64.AppImage(桌面)

Windows SmartScreen 提示:安装包未做 Authenticode 签名——如 SmartScreen 提示,点保留 / 更多信息 → 仍要运行。EMRG 完全开源,源码可审计。

首次使用:打开 EMRG → 引导配置 API Key / 模型 → 开始对话。TUI 同步可用:任意终端运行 emrg 即可(配置共享)。

自带 API Key — EMRG 使用你自己的 LLM API Key 和额度/账单;软件本身免费、MIT 开源。

想从源码安装,或需要高级配置 / 架构 / 贡献者文档?→ DEVELOPMENT.md


运行 TUI(终端版)

EMRG 骨子里是个终端应用——Electron GUI 只是同一引擎上的便捷外壳。

运行:打开终端,输入 emrg,回车即可。安装器已把 emrg 加入 PATH(含 Windows),首次运行会自动拉起后台守护进程并进入交互式 TUI。

首次运行 emrg 会自动拉起后台守护进程(emrgd)并进入交互式 TUI。守护进程常驻后台,可随时重连。

守护进程管理:

命令 作用
emrg 启动 TUI(必要时自动启动 daemon)
emrg server 前台运行 daemon
emrg server stop 停止后台 daemon
emrg server restart 重启 daemon
emrg rant <msg> [@project] 从命令行发反馈(无需进 TUI)
emrg update 更新到最新版本

TUI 内:Esc 中断流式输出,Ctrl+C / exit 退出(配置与 GUI 共享——API Key 只需在一处设置一次)。


命令一览

全部命令在 GUI 与 TUI 均可使用(GUI 输入框敲 / 弹出补全菜单;TUI /help 列出全部)。

命令 功能
直接打字 问 EMRG 任何事——它会读文件、跑命令、做编辑
/ 命令自动补全菜单——输入即过滤,↑↓ 选择
/resume [id] 切换会话——不带参数进入交互式选择器(↑↓/j/k)
/sessions 浏览所有已保存的会话(↑↓/j/k)
/clear 清空当前会话——重新开始
/compact 压缩长对话以节省上下文
/memory 浏览项目和会话记忆
/rename [标题] 给当前会话起个好记的名字
/model [name] 切换 LLM 模型——不带参数进入交互式选择器
/rant <反馈> [@<project>] 吐槽、建议、夸奖——演化系统会听
/help 查看所有键盘快捷键和命令帮助
/image 从剪贴板插入图片到输入框
/delete [id] 删除会话——不带参数进入交互式选择器
/rewind 回退对话到历史某个节点
/trigger 触发演化任务——交互式选择器(任务管理在 GUI 设置 → 定时任务)
/skills 列出已加载技能;/skills available|install|update
/version 显示 EMRG 版本和实例信息
Esc 中断正在运行的响应
Ctrl+C / exit 退出

与竞品对比

Claude Code Codex DeepSeek Harness EMRG Grok Bot
AI 驱动编程
工具调用 (bash, read, write, edit, glob, grep)
会话记忆与上下文
/ 命令自动补全 ~ @ mention 建议 + 命令面板
ESC 中断
插件化架构 一切皆插件
沙箱执行 read-only / workspace-write / danger-full-access ~ protectedBoxPaths + /workspace
子代理 assistants/automations 生态
Web UI 浏览器 Electron Electron
自主进化 全自动
后台守护进程 持久运行 host + node-agent-coordinator 协调层
吐槽驱动自我改进 /rant → PR
开源 Apache-2.0 MIT MIT 商业

DeepSeek Harness 是插件化 agent harness,工程纵深强(沙箱、子代理、工作流)——但它不自我进化。EMRG 同样具备三档沙箱(read-only / workspace-write / danger-full-access),并以闭环取胜:自进化、持久后台守护进程、吐槽驱动改进。Grok Bot 是 Anysphere 的商用 Electron 应用,具备插件/助手生态,但不开源、不自我进化。

EMRG 不只是追赶——它自己追上来。


常见问题

这是真的吗——它真的会改自己的代码?
真的。演化循环读取演化提示词,回顾 rant + issue + 竞品工具,修改源码,跑测试,然后提交 PR。如果测试失败,自动回滚。

它会把自己搞崩吗?
每次改动都会通过 pytest 和 import 检查验证后才提交。失败的改动会被丢弃;最坏的情况就是回滚。

它会动我项目的代码吗?
不会。自我进化只修改它自己的仓库(~/.emrg/evolution/emrg),从不碰你的项目文件。它在你项目上运行的工具,只有你让它运行的那些——而且它做的每处改动都是经过测试、走 PR 评审的。

和 Claude Code 或 Codex 有什么不同?
它们是产品。EMRG 是一个关于闭环进化的实验——AI 改进 AI。完全开源,无厂商锁定。


开发

贡献指南、源码安装、架构、详细 FAQ → DEVELOPMENT.md

快速检查:uv run pytest tests/ -v · cd emrg/gui && npm test(测试:见上方徽章)


许可证

MIT — 详见 LICENSE 了解完整条款,MANIFESTO.md 了解代码背后的设计哲学。


argszero 和持续进化的 AI 共同打造 ❤️