项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2890
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js 与 npm(README 使用 npm ci,未给出具体版本)
- Git(需支持 --recursive 子模块克隆)
- 可运行桌面应用的图形环境(项目为 Tauri 桌面端)
- Rust 工具链(Tauri 构建需要,README 未显式说明)
安装与启动步骤
-
1克隆仓库
使用 --recursive 一次性拉取主仓库与全部子模块,否则后续无法直接构建。
git clone --recursive https://github.com/Pinvou/pinvou-agent.git -
2补装子模块
如果克隆时漏了 --recursive,在仓库根目录执行此命令补全子模块。
git submodule update --init --recursive -
3安装前端依赖
进入 pinvou3-app 目录,用 npm ci 按锁文件安装依赖,需保证 Node 与 npm 可用。
cd pinvou-agent/pinvou3-app npm ci -
4启动开发模式
回到仓库根目录执行 run-dev.sh,脚本会拉起应用开发环境,首次编译耗时较长。
cd .. ./pinvou3-app/run-dev.sh -
5下载预览版
不想从源码编译,可直接在 GitHub Releases 页面下载官方 Preview 安装包。
如何确认成功
执行 run-dev.sh 后终端无报错并弹出 Pinvou Agent 桌面窗口即视为启动成功;README 未给出显式验证方法。
常见问题
Q:克隆时忘记加 --recursive 怎么办?
A:在仓库根目录执行 git submodule update --init --recursive 补全子模块即可,无需重新克隆。
Q:不想自己编译,有现成安装包吗?
A:有。README 提供 Download Preview 链接,指向 GitHub Releases 页面,可直接下载官方预览版本。
Q:可以用本地模型或第三方模型吗?
A:README 说明可用本地模型实现完全私密的本地环路,也可连接任何 OpenAI 兼容端点,并通过 MCP 服务器扩展。
Q:npm ci 报错怎么排查?
A:README 未指定 Node 版本要求,建议升级到 Node.js LTS 后重试,并确认当前目录为 pinvou3-app。
注意事项
- README 未给出 Node / Rust 版本要求、端口、路径与任何配置项,实际以仓库最新文档为准。
- 执行顺序不能颠倒:先在 pinvou3-app 目录跑 npm ci,再回仓库根目录运行 run-dev.sh。
- 项目处于早期 Preview 阶段,强调本地优先与数据隐私。
- 首次构建需下载 Tauri 相关依赖,耗时可能明显长于普通前端项目。
核心亮点
- 本地优先架构,数据隐私安全,敏感操作不出本机
- 基于 Tauri + Rust,内存占用低,启动快,桌面体验流畅
- 支持 MCP 协议,可灵活接入多种 LLM 和外部工具生态
不足之处
- 早期项目,功能完整性和稳定性有待验证
- 文档和社区生态尚不完善,上手门槛较高
适用场景
- 个人知识库管理与自动化整理
- 自动化处理重复性办公任务(如文件整理、报告生成)
- 开发者快速搭建本地 AI 自动化工作流
替代项目
Open Interpreter、AutoGPT、CrewAI
上一篇:VibeAround
下一篇:deepagent-code
同类项目推荐
html-anything
开源
AI 写好页面你只管上线,75 个技能随叫随到
✨ The agentic HTML editor — your local AI agent writes the HTML, you ship it. 75 ···
claude-forge
开源
给 Claude Code 装上 11 个代理和 36 个命令,5 分钟搞定扩展。
oh-my-zsh for Claude Code — 16 agents, 35 commands, 32 skills, 21 safety hooks in o···
AI-Photographer-Agent-ROCm
开源
在AMD显卡上本地运行AI摄影师,离线获得专业拍摄指导。
Private local AI Photographer Agent on AMD Radeon and ROCm
openmcp-client
开源
在 VS Code 里一站式开发、调试和测试 MCP 服务器,省去切换工具的麻烦。
All in one vscode plugin for mcp developer
daofy
开源
让 AI 助手直接编译和查询 Delphi 项目,提升开发效率
Daofy for Delphi — MCP Server that compiles Delphi projects and queries knowledge b···
Sponsio
开源
给AI智能体装上确定性安全锁,让每一次工具调用都可控可审计。
Deterministic safety solutions for probabilistic AI agents
Aether
开源
在手机和电脑上本地跑 AI 智能体,隐私又流畅
Codex for Android, iOS & Mac. | Aether 扶摇
agentcraft
开源
用 TypeScript 快速搭建你的 AI Agent 应用
agentcraft 可以帮助您快速构建各类应用场景的ai agent应用
opsy
开源
在终端里用大白话指挥 K8s,自动生成命令并解释结果
Opsy - Your AI-Powered SRE Colleague
