by shiwenwen
会记忆、能成长的随身 AI 助手 · 桌面 / 云端 / IM 随叫随到，手机远程也能连 | Personal AI that remembers and grows — lives on desktop, self-hosted server and every IM, reachable anywhere
# Add to your Claude Code skills
git clone https://github.com/shiwenwen/hope-agentHope Agent 是一款面向普通人的 AI 助手——我们把重心放在强大的桌面 GUI 和系统深度融合上，同时它也能以服务形态常驻后台，部署到 NAS、自家服务器或云主机上，在 IM 渠道里随叫随到。一个原生安装包，主流大模型 GUI 模板内置齐全，填完 API Key 就能开聊。它能跨会话记住你、空闲时自己整理记忆、把做过的任务沉淀成可复用的技能。
普通人需要一个打开就能用的 AI 助手——下载安装包双击打开就行，不用先装运行时，也不用先学一套命令行，更不用担心看不懂配置、服务半夜崩了没人管。Hope Agent 不只是桌面 GUI，它还能以 HTTP/WS 服务常驻，放在 NAS、自家服务器或云主机上 7×24 跑着，同时接入 IM 渠道、对接 IDE（ACP）；但我们相信大多数普通人的入口仍然是桌面，所以在桌面 GUI 和系统深度融合上投入了最多的精力，同时把性能、稳定性和交互细节一起打磨好。
Hope Agent 早期曾受 openclaw 影响，感谢他们在本地 AI 助手方向上的先行工作——我们选择了不同的实现路径。
更多细节亮点请查看 CHANGELOG.md。
🛠 Release 状态：0.1.0 已可用但未发布二进制——我们想再打磨一轮首次体验再发。代码随时可用，如果你感兴趣，
pnpm tauri build即可得到与 Release 完全一致的产物，详见下方「开发者」。
Hope-Agent_*.dmghope-agent_*.AppImageHope-Agent_*.exe / Hope-Agent_*.msi（尚未完成充分测试）git clone https://github.com/shiwenwen/hope-agent.git
cd hope-agent
pnpm install
pnpm tauri dev # 桌面开发模式（前端 + Rust 热重载）
# 其他常用命令
pnpm typecheck # 前端类型检查（tsc -b）
pnpm lint # Lint
pnpm tauri build # 打生产包
No comments yet. Be the first to share your thoughts!
本地开发时如果想在浏览器里看“网页版”并实时刷新，运行 pnpm tauri dev 后打开 http://localhost:1420。这是 Vite dev server，和 Tauri 窗口共用前端热更新；http://localhost:8420 是内嵌 HTTP/WS 服务提供的静态 Web GUI（来自 dist/ / embedded bundle），用于模拟打包后的浏览器入口，不会跟随源码 HMR。若本地 Server 开了 API Key，1420 页面请求 8420 可能返回 401，开发时可先在设置里临时清空 Server API Key 后重启。
| 模式 | 启动方式 | 场景 |
| ----------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| 桌面 GUI | 双击图标 / pnpm tauri dev | 功能最全的入口：完整 GUI 体验，并内嵌 HTTP/WS 服务，桌面在用的同时可对外提供接入 |
| Server + Web GUI（HTTP/WS） | 通过 server start 子命令；server install 可注册成 launchd / systemd 开机自启 | 无 GUI 守护进程，24 小时在线，IM 渠道 / Cron 不断线；前端 React UI 通过 rust-embed 内嵌进 server 二进制，浏览器打开 http://<server>:port 即得完整 Web GUI，手机 / 平板 / 任意电脑都能直连 |
| ACP（stdio） | 通过 acp 子命令 | IDE 直连，兼容 ACP 协议的编辑器把 Hope Agent 当 agent 后端调 |
三种模式共用同一套 ha-core 核心逻辑；配置、会话、记忆全部落在 ~/.hope-agent/ 下。