$git clone https://github.com/shiwenwen/hope-agent---
| 1 | <p align="center"> |
| 2 | <img src="assets/alpha-logo.png" alt="Hope Agent" width="200"> |
| 3 | </p> |
| 4 | |
| 5 | <h1 align="center">Hope Agent</h1> |
| 6 | |
| 7 | <p align="center"> |
| 8 | <strong>跨端交接、越用越懂你的桌面 AI 助手,也能服务化常驻、跑在云上</strong><br/> |
| 9 | 会记忆 · 能成长 · 能自主推进目标 · 会动态编排任务 · 在你所有的聊天里随叫随到 |
| 10 | </p> |
| 11 | |
| 12 | <p align="center"> |
| 13 | <a href="https://github.com/shiwenwen/hope-agent/actions/workflows/rust.yml"><img src="https://img.shields.io/github/actions/workflow/status/shiwenwen/hope-agent/rust.yml?branch=main&style=flat-square&logo=githubactions&logoColor=white&label=CI" alt="CI status"></a> |
| 14 | <a href="https://github.com/shiwenwen/hope-agent/releases"><img src="https://img.shields.io/badge/macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS"></a> |
| 15 | <a href="https://github.com/shiwenwen/hope-agent/releases"><img src="https://img.shields.io/badge/Linux-experimental-FFA500?style=flat-square&logo=linux&logoColor=black" alt="Linux (experimental)"></a> |
| 16 | <a href="https://github.com/shiwenwen/hope-agent/releases"><img src="https://img.shields.io/badge/Windows-experimental-FFA500?style=flat-square&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0wIDMuNDQ5TDkuNzUgMi4xdjkuNDUxSDBtMTAuOTQ5LTkuNjAyTDI0IDB2MTEuNEgxMC45NDlNMCAxMi42aDkuNzV2OS40NTFMMCAyMC42OTlNMTAuOTQ5IDEyLjZIMjRWMjRsLTEyLjktMS44MDEiLz48L3N2Zz4=" alt="Windows (experimental)"></a> |
| 17 | <a href="#运行模式"><img src="https://img.shields.io/badge/Web%20GUI-browser-4F46E5?style=flat-square&logo=googlechrome&logoColor=white" alt="Web GUI"></a> |
| 18 | <a href="https://www.rust-lang.org/"><img src="https://img.shields.io/badge/Rust-edition%202021-dea584?style=flat-square&logo=rust&logoColor=white" alt="Rust"></a> |
| 19 | <a href="https://tauri.app/"><img src="https://img.shields.io/badge/Tauri-2-24C8DB?style=flat-square&logo=tauri&logoColor=white" alt="Tauri"></a> |
| 20 | <a href="https://react.dev/"><img src="https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=black" alt="React"></a> |
| 21 | <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=flat-square" alt="License: MIT"></a> |
| 22 | </p> |
| 23 | |
| 24 | <p align="center"> |
| 25 | <strong>简体中文</strong> · <a href="./README.en.md">English</a> |
| 26 | </p> |
| 27 | |
| 28 | --- |
| 29 | |
| 30 | **Hope Agent** 是一个本地优先、桌面优先,也能服务化常驻的个人 AI Agent。它像成熟的桌面软件一样打开即用,又真正具备 Agent 的行动力:理解长期上下文、调用工具完成工作,并在你离开后继续可靠地推进目标。 |
| 31 | |
| 32 | **Hope Agent 很早就开始探索桌面 AI Agent。** 在桌面 Agent 还很少见、Codex 尚处早期形态的阶段,我们就已经开始构建这个项目。我们一直专注于产品本身,而不是制造声量。随着桌面 AI Agent 逐渐成为热门方向,越来越多产品开始探索相似路径,也印证了我们最初的判断:**AI 助手终将走出聊天框,成为可以长期托付工作的个人软件。** |
| 33 | |
| 34 | ## 目录 |
| 35 | |
| 36 | - [核心能力](#核心能力) |
| 37 | - [能力全景](#能力全景) |
| 38 | - [快速开始](#快速开始) |
| 39 | - [下载安装](#下载安装) |
| 40 | - [自托管(Docker)](#自托管docker) |
| 41 | - [开发者](#开发者) |
| 42 | - [运行模式](#运行模式) |
| 43 | - [生态一览](#生态一览) |
| 44 | - [项目结构](#项目结构) |
| 45 | - [文档](#文档) |
| 46 | - [贡献](#贡献) |
| 47 | - [社区](#社区) |
| 48 | - [致谢](#致谢) |
| 49 | - [Star History](#star-history) |
| 50 | - [License](#license) |
| 51 | |
| 52 | ## 核心能力 |
| 53 | |
| 54 | <table> |
| 55 | <tr><td width="220"><b>🖥️ 开箱即用的桌面 Agent</b></td><td>原生 GUI、丰富的 Provider 模板与预设模型,并支持本地模型一键安装。填入 API Key 或登录账号即可开始,不要求先搭环境、学命令行或维护复杂配置。</td></tr> |
| 56 | <tr><td><b>🧭 持续完成,而不只回答</b></td><td>Goal 定义结果,Workflow 动态组织执行,Loop 决定何时继续。复杂任务可以在后台推进,并随时查看、暂停、恢复或调整。</td></tr> |
| 57 | <tr><td><b>🧠 长期记忆与知识空间</b></td><td>跨会话记忆、按需召回、离线整理、用户画像与可复用技能逐步积累;知识空间让你和 AI 共同读写真实 Markdown,形成可追溯的第二大脑。</td></tr> |
| 58 | <tr><td><b>🎨 从想法到可交付设计</b></td><td>设计空间从一句话或参考图生成网页、移动原型、演示文稿等 10+ 类产物,支持可视化微调、版本管理、多格式导出,并能继续交付到真实代码工程。</td></tr> |
| 59 | <tr><td><b>🛠️ 真正能够操作和执行</b></td><td>在授权与审批下控制电脑和浏览器,运行命令、读写文件、调用 MCP、连接工作空间,并通过多 Agent 协作完成复杂工作。</td></tr> |
| 60 | <tr><td><b>🌐 跨端交接,随时在线</b></td><td>Desktop / Server / Web / ACP 共用同一套核心;同一份会话、记忆与任务状态可以在桌面、浏览器和常用 IM 渠道之间继续。</td></tr> |
| 61 | <tr><td><b>🛡️ 本地优先、可控可靠</b></td><td>数据默认保存在本机,模型请求直连 Provider;工具审批、Docker 沙箱、配置回滚、崩溃恢复与后台保活共同守住长期运行边界。</td></tr> |
| 62 | </table> |
| 63 | |
| 64 | ## 能力全景 |
| 65 | |
| 66 | ### 🎨 设计与知识 |
| 67 | |
| 68 | <table> |
| 69 | <tr><td width="220"><b>🎨 设计空间</b></td><td>从一句话或参考图生成网页、移动原型、演示文稿、仪表盘、海报、文档、邮件、图像、动效、音频与交互组件。生成过程实时预览,项目内置 AI 对话、元素微调、批注、撤销重做、设备预览、版本历史与产物库,可导出 HTML / PNG / PDF / PPTX / MP4 / ZIP。</td></tr> |
| 70 | <tr><td><b>🧩 设计系统到代码</b></td><td>可从截图、网址、Figma 或现有代码仓库提取品牌设计系统,跨产物复用并导出多平台 Design Token 与代码交付包。设计项目可绑 |