Pinvou/pinvou-agent

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

Pinvou Agent – 데스크톱 AI 어시스턴트 워크스페이스

무엇인가요 – 실제 세계의 어시스턴트로 대화형 AI와 작업할 수 있는 오픈소스 데스크톱 애플리케이션입니다. 채팅, 파일 처리, 지식 기반 검색, 도구 통합을 세 가지 "모드"로 통합: 작업 (연구, 글쓰기, 분석), 디자인 (프롬프트를 편집 가능한 포스터나 차트로 변환), 코드 (실제 코드베이스에 코딩 에이전트를 도입). 앱은 로컬에서 완전히 실행 가능(예: vLLM 서버 사용)하거나, 어떤 OpenAI 호환 API에도 연결 가능하며, 플러그인 스타일의 스킬, MCP 서버, CLI 도구, 제3자 커넥터를 통해 확장 가능합니다.

핵심 개념 및 워크플로우

개념	얻는 것
워크스페이스	제목이 있는 세션으로, 채팅 기록, 도구 호출, 생성된 아티팩트(파일, 마크다운, 이미지 등)를 지속적으로 보관합니다.
아티팩트 패널	에이전트가 생성/편집한 모든 파일을 자동 수집; 미리보기, 열기, 추가 편집이 가능합니다.
계획 / YOLO 모드	실행 전 단계별 계획을 보여줄지, 또는 작업이 명확할 경우 에이전트가 바로 실행되게 할지 선택합니다.
지식 기반	첨부된 PDF, Office 문서, 이미지 등에 대한 로컬 벡터/전체 텍스트 검색; 채팅별로 컬렉션의 활성화/비활성화를 전환 가능합니다.
페르소나 카드	저장된 전문 역할(예: "법률 분석가", "디자이너")로 모델의 행동을 편향시킬 수 있습니다.
스킬 및 워크플로우	에이전트가 안정적이고 반복 가능한 능력으로 호출할 수 있는 재사용 가능한 명령어 묶음입니다.
도구 스토어	로컬 MCP 서버, 원격 MCP 서버, CLI 도구, API 커넥터(Feishu, DingTalk, Obsidian 등)의 중앙 카탈로그입니다.
원격 제어	QR 코드를 스캔하여 스마트폰에서 실행 중인 워크스페이스를 확인하거나 조정할 수 있습니다.
음성 입력	필요 시 손을 떼고 프롬프트를 입력할 수 있는 옵션의 음성 인식 모델입니다.

주목할 만한 기능

제목 검색 기능이 있는 멀티세션 UI로, 프로젝트 간 빠르게 이동 가능.
파일 첨부 처리 – PDF, Office 파일, 이미지, 아카이브를 드래그 앤 드롭 가능; 에이전트는 이를 읽고 작동할 수 있습니다.
편집 가능한 마크다운 아티팩트 – 직접 편집하거나 에이전트에게 선택한 부분을 다시 작성해 달라고 요청할 수 있습니다.
벡터 검색을 지원하는 로컬 지식 기반으로, 각 파일의 출처를 유지합니다.
장기적 선호사항을 저장하는 메모리 센터로, 후보 메모리를 확인 후 저장합니다.
확장 가능한 커넥터 생태계 – 지원 시 OAuth/SSO 제공, 인기 있는 중국 기업용 도구용 미리 준비된 커넥터 포함.
코드 모드는 ACP (에이전트-코드-프로토콜)를 통해 Codex, Claude Code, Kimi를 지원하여 에이전트가 실제 프로젝트 파일을 읽고 쓰며, 명령어를 실행하고 작업 계획을 표시할 수 있습니다.
디자인 모드는 자연어 프롬프트에서 포스터나 데이터 시각화를 생성한 후, 앱 내에서 그래픽적으로 편집할 수 있습니다.

기술 스택

Tauri 2 – 네이티브 데스크톱 래퍼(Rust 백엔드, WebView 프론트엔드). Windows, macOS, Linux용 크로스플랫폼 빌드 제공.
React 19 + Vite – UI 계층.
Rust 엔진 (CodeWhale 하위 모듈) – 모델 호출, 스트리밍, 도구 실행, MCP 서버 오케스트레이션, 스킬, 세션 관리 처리.
모델 접근 – 어떤 OpenAI 호환 엔드포인트(OpenAI, Anthropic, Gemini, DeepSeek, Kimi, Qwen 등) 및 로컬 vLLM 서버와 호환.
파일 시스템 구조 – 모든 사용자 데이터는 ~/.pinvou3/ 아래에 저장됨(세션, 지식 컬렉션, 설정, 확장 기능).

시작하기 (빠른 시작)

사전 요구 사항 설치: Git(서브모듈 지원), Node ≥ 18, 최신 Rust 툴체인, OS용 Tauri 2 시스템 종속성.

리포지토리 재귀적으로 클론:

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

앱 설정에서 모델 구성 추가(로컬 vLLM URL 또는 클라우드 API 키).
새 워크스페이스 생성, 파일 첨부, 페르소나 또는 스킬 선택, 작업, 디자인, 코드 모드에서 작업 시작.

사전 빌드된 바이너리도 릴리스 페이지에서 세 플랫폼 모두에 대해 사용 가능합니다.

확장성

스킬 – SKILL.md 패키지를 추가하여 도구나 방법을 설명; 에이전트는 어떤 세션에서도 호출 가능.
MCP 서버 / CLI 커넥터 – 통합된 도구 스토어를 통해 외부 서비스(예: 기업 지식 기반)를 연결.
사용자 정의 지침 – 스킬과 함께 instructions.md를 패키지화하여 모델 행동을 조정.
UI 변경 – pinvou3-app/ 폴더 수정; 엔진 변경은 CodeWhale/ 하위 모듈로.

커뮤니티 및 거버넌스

채팅 및 지원 – QQ 그룹(중국어) #1108909346, GitHub Issues, Discussions.
보안 – SECURITY.md에 정의된 비공개 보고 채널.
기여 – CONTRIBUTING.md를 따르고 CodeWhale 엔진의 포크 정책을 준수하세요.

라이선스

결론 – Pinvou Agent는 일상 업무, 시각 디자인, 소프트웨어 개발에 실용적인 어시스턴트로 대화형 LLM을 활용할 수 있는 기능이 풍부한 크로스플랫폼 데스크톱 환경입니다. 로컬에서 실행하면 데이터를 개인 정보 보호할 수 있습니다. 현대 웹네이티브(React/Vite)와 네이티브(Tauri/Rust) 기술로 구축되었으며, 모듈식 스킬/커넥터 생태계를 통해 확장 가능하도록 설계되었습니다.