Gravity

   English

✅ 本地优先（默认本地存储）| 开源可审计 | Chat / Agent 双模式
✅ 多供应商接入 | 文件解析对话 | 流式输出 | Skills & MCP
✅ Windows / macOS | OpenAI 兼容接口 | Anthropic Agent 工作流

Gravity 是一个面向生产效率的 AI 桌面应用，核心目标是把通用对话、自动化 Agent 与本地数据安全放到同一个工作流里。 你可以从聊天开始，也可以在 Agent 模式中把多步骤任务交给 AI 持续执行。

🎬 可视化演示

✨ 核心特性

🚀 快速使用（推荐路径）

1. 下载最新版本：GitHub Releases
2. 启动应用后进入 设置 > 渠道管理，添加你的 API Key 并测试连接。
3. 在 Chat 模式直接对话，或在 Agent 模式选择 Anthropic 渠道后执行任务。

Requirements & Limits（环境要求与限制）

• Agent 模式需要可用的 Node.js 与 Git 运行环境。
• Agent 模式当前依赖 Anthropic 渠道。
• 本地数据默认写入 ~/.gravity/，请确保目录有读写权限。

Developer Guide（本地开发）

# 1) 安装依赖
bun install

# 2) 避免 Electron 以 Node 模式运行（Windows 常见问题）
Remove-Item Env:ELECTRON_RUN_AS_NODE -ErrorAction SilentlyContinue

# 3) 启动开发模式（Vite + Electron）
npm run dev

# 4) 构建
npm run build

Troubleshooting / Known Issues（常见问题）

• ERR_CONNECTION_REFUSED：通常是只启动了 Electron，未启动 Vite dev server，请使用 npm run dev。
• whenReady 相关报错：先清理环境变量 ELECTRON_RUN_AS_NODE 后重启。
• 5173 端口冲突：关闭占用进程或修改 Vite 端口配置。

开源许可

MIT

🤝 贡献与联系

欢迎提交 Issue 和 Pull Request！
如有任何问题或建议，请联系 Zheyuan (Max) Kong (卡内基梅隆大学，宾夕法尼亚州)。

Zheyuan (Max) Kong: kongzheyuan@outlook.com | zheyuank@tepper.cmu.edu