openvetta /open-vetta

Open-source, local-first AI agent for coding and real work. BYOK models, MCP, skills, plugins, workflows, and private knowledge bases.

★ 299⑂ 50👁 1⑃ 16● 57▤ 26
TypeScriptApache-2.0Created 2026-08-03www.openvetta.com
Download: Vetta 0.5.82Vetta-0.5.82 ↓0.5.822026-11-15
+0
Daily
299
stars
50
forks
1
watchers
16
prs
57
issues
26
releases

README

Open Vetta


  An open-source desktop AI agent for real work — local-first, extensible, and under your control.



  
  
  
  
  
  



  English ·
  简体中文 ·
  Download ·
  Get started ·
  Discussions ·
  Discord ·
  Contributing


---

Open Vetta brings models, project files, local tools, and reusable capabilities into one desktop workspace. Use it for coding, documents, data, research, creative work, and repeatable workflows without giving up control of the environment where the work happens.

It is more than a chat interface: Vetta can inspect a workspace, use tools with visible permission boundaries, produce real files, and keep the execution trail available for review.


  


 Why Open Vetta

| | What it means |
|---|---|
| Local-first workspace | Projects, sessions, files, and execution live in the environment you choose. |
| Bring your own models | Connect supported providers, OpenAI-compatible endpoints, or local inference through BYOK. |
| Real tools and artifacts | Work with code, documents, spreadsheets, media, commands, and generated files in one task flow. |
| Reviewable execution | Tool calls, plans, permissions, progress, results, and recovery paths remain visible. |
| Reusable workflows | Extend the agent with skills, MCP servers, plugins, themes, knowledge, batch tasks, and automation. |
| Open client stack | The desktop app, CLI, SDK, plugin system, themes, mobile client, and IM gateway are developed in this repository. |

 Start here

| I want to… | Start with |
|---|---|
| Use the desktop app | Download for macOS, Windows, or Linux, then follow installation and first setup. |
| Complete a real task | Follow the first-task walkthrough. |
| Understand the product | Read the product guide and security and data boundaries. |
| Build an extension | Choose between skills, MCP, plugins, themes, SDK, RPC, and CLI. |
| Contribute code | Read QUICKSTART.md and CONTRIBUTING.md. |

 Run from source

Requires Bun 1.3+ and Node.js 20+.

bash
git clone https://github.com/openvetta/open-vetta.git
cd open-vetta
git switch dev
bun install
cd apps/desktop
bun run dev


The development app uses ~/.vetta-dev by default, keeping installed-app data in ~/.vetta untouched. Root-level bun run dev watches core libraries; it does not launch Electron. See QUICKSTART.md for the complete setup and validation commands.

 What you can do

- Work in projects and sessions. Keep task history, files, context, artifacts, and execution details together.
- Use local and external tools. Run commands, inspect files, connect MCP services, and approve sensitive operations explicitly.
- Handle professional artifacts. Preview and work with source code, PDF, Office files, spreadsheets, images, audio, video, SVG, and generated UI.
- Scale a proven task. Run the same workflow across directories with batch tasks, or schedule it as an automation.
- Reuse organizational knowledge. Build local knowledge bases and install reusable skills or scenarios.
- Keep working away from the 

Top issues

Discussions

Latest release

Vetta 0.5.82 v0.5.82 2026-11-15
Vetta 0.5.82


 改进

- macOS 按 Cmd+Q 或选择应用菜单中的「退出 Vetta」时,会先询问是否退出;可按 Esc 取消、回车确认,每次都会询问,不提供「不再询问」选项。

 修复

- 修复 macOS 会话页偶尔带动侧边栏整体上移、窗口底部露出空白的问题,无需新建会话恢复布局。

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON