About Hope Agent
Hope Agent is an MCP server in the Blockchain category: 会记忆、能成长的随身 AI 助手 · 桌面 / 云端 / IM 随叫随到，手机远程也能连 | Personal AI that remembers and grows — lives on desktop, self-hosted server and every IM, reachable anywhere.
Install
git clone https://github.com/shiwenwen/hope-agentThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Hope Agent
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
Hope Agent 是一款面向普通人的 AI 助手。同一份会话能在你的设备和聊天之间随手交接，并在日复一日的使用里自己变好——跨会话记忆持续累积、空闲时自己整理、做过的事沉淀成可复用的技能。一个原生安装包，主流大模型 GUI 模板内置齐全，填完 API Key 就能开聊；同时它也能以服务形态常驻 NAS / 自家服务器 / 云主机，在 IM 渠道里随叫随到。
缘起
普通人需要一个打开就能用的 AI 助手——下载安装包双击打开就行，不用先装运行时，也不用先学一套命令行，更不用担心看不懂配置、服务半夜崩了没人管。Hope Agent 不只是桌面 GUI，它还能以 HTTP/WS 服务常驻，放在 NAS、自家服务器或云主机上 7×24 跑着，同时接入 IM 渠道、对接 IDE（ACP）；但我们相信大多数普通人的入口仍然是桌面，所以在桌面 GUI 和系统深度融合上投入了最多的精力，同时把性能、稳定性和交互细节一起打磨好。也希望它能陪着你长期用下去——同一份会话跨设备和聊天接续，记忆和技能慢慢累积下来。
Hope Agent 早期曾受 openclaw 影响，感谢他们在本地 AI 助手方向上的先行工作——我们选择了不同的实现路径。
亮点
🎯 日常使用
🧠 记忆与学习
🛠 工作流 & 工具
🛡 安全与本地化
更多细节亮点请查看 CHANGELOG.md。
快速开始
普通用户
📦 安装包：Releases
- 到 Releases 下载对应平台安装包
- macOS：
Hope-Agent_*.dmg - Linux：
hope-agent_*.AppImage - Windows：
Hope-Agent_*.exe/Hope-Agent_*.msi（尚未完成充分测试）
- macOS：
- 首次启动向导：选 Provider 模板 → 填 API Key / Codex OAuth 登录 → 开聊
- 桌面安装包内置 GitHub Releases 自动更新；应用内可在 设置 → 关于 里检查更新并一键安装
开发者
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 # 打生产包
本地开发时如果想在浏览器里看“网页版”并实时刷新，运行 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/ 下。
生态一览
项目结构
Cargo Workspace 三 Crate 架构，核心业务逻辑全部在 ha-core：
crates/
ha-core/ Rust 核心库（零 Tauri 依赖）— 所有业务逻辑在这里
ha-server/ axum HTTP/WS 守护进程（薄壳）
src-tauri/ Tauri 桌面 Shell（薄壳）
src/ React 19 + TypeScript 前端
skills/ 内置技能（随应用发行）
完整的模块拓扑、架构约定、编码规范见 AGENTS.md。
文档
详见 docs/。
贡献
主分支处于活跃开发阶段，欢迎 issue / PR。贡献前请先读一遍 AGENTS.md 的 "架构约定" 和 "编码规范" 两节。
常用命令：
pnpm tauri dev # 桌面开发
cargo check --workspace # Rust 依赖 / 类型检查
cargo test -p ha-core -p ha-server # 核心测试
node scripts/sync-i18n.mjs --check # 检查翻译缺失
社区
- 🐛 Issues — Bug 报告、功能请求
- 💡 Discussions — 用法分享、想法讨论、提问答疑
- ⭐ 如果 Hope Agent 帮到了你，欢迎在 GitHub 上点个 Star
- 📮 路线图、正式文档站和更多社区渠道正在筹备中
致谢
- openclaw：在本地 AI 助手方向上的启发
- Ollama：本地大模型一键安装能力建立在 Ollama 的本地运行时与 OpenAI 兼容端点之上；Hope Agent 仅作 GUI 层包装，Qwen / Gemma 等模型由 Ollama 模型库分发
- ClawHub / SkillHub：为 Hope Agent 提供公开的 skill 搜索与发现来源
- Hermes Agent（间接溯源 obra/superpowers）：部分内置编程方法论 skill 改编自此（MIT），详见 THIRD_PARTY_NOTICES.md
- Tauri、axum、React、shadcn/ui、Streamdown、Radix UI 等开源基础设施
- 所有为这个项目做过反馈、测试、提交 issue 的朋友
Star History
License
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.