pinvou-agent

Name: pinvou-agent
Author: Pinvou

Verified

Open-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables.

895stars

127forks

Rust

Installation

# Add to your Claude Code skills
git clone https://github.com/Pinvou/pinvou-agent

Getting Started

Guides for using ai agents skills like pinvou-agent.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 7/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-07-30T06:27:18.688Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is pinvou-agent?

pinvou-agent is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Pinvou. Open-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables. It has 895 GitHub stars.

Is pinvou-agent safe to use?

Yes. pinvou-agent passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install pinvou-agent?

Clone the repository with "git clone https://github.com/Pinvou/pinvou-agent" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is pinvou-agent written in?

pinvou-agent is primarily written in Rust. It is open-source under Pinvou on GitHub, so you can review or fork the full source.

Are there alternatives to pinvou-agent?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh pinvou-agent against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

240,529

fablize CORAL

Pinvou Agent

An open-source desktop AI agent workspace for work, design, and coding.

English · 简体中文

Download Preview · Website · Issues · Discussions · Security

Pinvou Agent is more than a chat window. It brings everyday work, visual design, and software development into one desktop workspace — designed for tasks that should end with a result, not just another chat response. Use tools, work with files, and build personal knowledge; bring a dedicated coding agent into a real project over ACP; or turn a prompt into a visual artifact you can continue editing.

Use a local model for a fully private loop, connect any OpenAI-compatible endpoint, and extend the agent with MCP servers, CLI connectors, Skills, and workflows.

🧭 One workspace, three ways to work

💼 Work: give the agent a real task

Combine attachments, personal knowledge, specialist personas, Skills, MCP tools, and workflows to research, analyze, write, and deliver reusable files — not just another block of chat text.

🎨 Design: from a prompt to an editable visual

Create posters and data visualizations in natural language. Open the result in design mode, select elements directly, and adjust copy, fonts, colors, dimensions, and layout — or keep describing changes and let the agent iterate on the current design.

💻 Code: bring a coding agent into a real project

Use Codex, Claude Code, or Kimi through ACP in the same desktop workspace. The coding agent can read and edit a real project or an isolated temporary workspace, run commands, and surface plans, tool steps, permission requests, and file changes. Sessions stay bound to their workspace and can be continued after restarting the app.

✨ Features

🎯 From conversation to deliverables

Multi-session workspace with title search — messages, tool calls, and artifacts persist with each session
Attachments for PDF, Office documents, images, and text — drag, drop, or paste them in
Artifact panel automatically collects every file the agent creates or edits; preview, locate, and open them in one place
Editable Markdown artifacts — edit directly, or select a passage and ask the agent to revise it
Plan / YOLO modes — review the plan first for complex work, or execute directly when the task is clear

🧠 Knowledge and memory

Local knowledge base with file management, full-text and vector retrieval; attach multiple collections to one chat, enable or disable each independently, and retain collection and file provenance in answers
Memory center captures long-term preferences and context, with explicit candidate review and confirmation
Persona card pool — create, save, and apply specialist roles for different domains
Skills, Commands, and workflows turn proven methods into stable, reusable capabilities

🔌 Real tools and connectors

Unified tool store for local MCP servers, remote MCP servers, CLI tools, and API connectors
OAuth / SSO authorization where supported — no manual key pasting
Ready-made connectors for Feishu (Lark), DingTalk, WeCom, Tencent Meeting, Tencent ima, Obsidian, enterprise knowledge bases, and legal / enterprise data services
Remote control — scan a QR code from your phone to view and steer the running workspace

🖥️ Built for daily operation

Local voice input with on-demand speech model downloads
Centralized monitoring of GPU, memory, disk, model service, and context usage
In-app updates on Linux, with OTA delivery on macOS and Windows
Sessions, settings, knowledge, and runtime extensions all live under ~/.pinvou3/

[!NOTE] Whether data leaves your machine depends on the model and tools you enable. A local model with local tools stays fully local. Cloud models, remote MCP servers, and third-party connectors send the relevant requests to their respective services.

📸 Screenshots

🤖 Model Access

Pinvou Agent works with local vLLM and any OpenAI-compatible API. Save multiple model configurations in the app and switch between them per session. Built-in templates cover local vLLM, DeepSeek, Kimi, Qwen, Doubao, MiniMax, Zhipu, and MiMo — or fill in any custom compatible endpoint.

Local vLLM example:

export DEEPSEEK_BASE_URL="http://127.0.0.1:8000/v1"
export DEEPSEEK_API_KEY="local-no-auth"
export DEEPSEEK_MODEL="your-model-name"

Endpoints, model names, and API keys can also be managed directly in the application settings. For a non-loopback plain HTTP endpoint in a trusted development network, explicitly set DEEPSEEK_ALLOW_INSECURE_HTTP=1.

🚀 Quick Start

Prerequisites

Git with submodule support
Node.js and npm
A current Rust toolchain
The Tauri 2 system dependencies for your platform
An accessible OpenAI-compatible model endpoint

The source tree supports Linux, Windows, and macOS. The initial macOS target is Apple Silicon on macOS 11 or later.

Run from source

git clone --recursive https://github.com/Pinvou/pinvou-agent.git
cd pinvou-agent/pinvou3-app
npm ci
cd ..
./pinvou3-app/run-dev.sh

If you cloned without submodules:

git submodule update --init --recursive

🏗️ Architecture

React + Vite UI
       ↕ Tauri commands / events
pinvou3-app (desktop orchestration)
       ↕ EngineHandle / AgentHarness
CodeWhale (agent engine submodule)
       ├─ OpenAI-compatible model services
       ├─ MCP servers and CLI connectors
       └─ Skills, Commands, Hooks, and Compaction

CodeWhale provides the agent engine: model calls, streaming, tool execution, sessions, MCP, Skills, hooks, and compaction. pinvou3-app/ owns the desktop UI, runtime configuration, orchestration, and operating-system integration — it never re-implements engine capabilities.

Extension goal	Where it belongs
Add a domain agent or tool bundle	A `SKILL.md` package
Connect an external API	An independent MCP server or connector
Guide model behavior	Bundle instructions (`instructions.md`)
Change desktop UI or system integration	`pinvou3-app/`
Fix a reusable engine issue	The CodeWhale fork, following the fork policy

📁 Repository Layout

pinvou3-app/          Tauri 2 + React/Vite desktop application
CodeWhale/            Agent engine submodule
pinvou3-app/resources/mcp-servers/
                      Independent local MCP servers
scripts/              Tests, guards, build, and release helpers
docs/                 Architecture and maintenance documentation

🧪 Development Checks

Run these commands from the repository root:

(cd pinvou3-app && npm run lint:ui)
(cd pinvou3-app && npm run build:ui)
(cd pinvou3-app && npm test)

(cd pinvou3-app/src-tauri && cargo test --lib -- --test-threads=1)

./scripts/fork-guard.sh --fast

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for the contribution workflow and CI gates, and docs/fork-policy.md for CodeWhale maintenance rules. By participating, you agree to our Code of Conduct.

💬 Community & Security

🐛 [GitHub Is