openworker README

The project's README from github.com/andrewyng/openworker. As one markdown file: README.md.

OpenWorker

openworker.com · Download · Issues

andrewyng%2Fopenworker | Trendshift

Beta - OpenWorker is in open beta: fully usable, updates itself, and we're actively polishing rough edges. Issues welcome.

AI that gets your everyday tasks done. OpenWorker is an open-source AI coworker that lives on your desktop and delivers finished work, not just chat: your code reviewed for vulnerabilities with fixes ready to go, a polished document, a Slack reply with the numbers, a triaged inbox. It ships specialist Security coworkers first — attackers already use AI, and defenders deserve the same leverage, governed.

It runs on your machine and doesn't lock you into any model: bring your own API key for OpenAI, Anthropic, Google, or an open-weight provider, or run fully local with Ollama. Your data leaves your machine only through the model and integrations you choose. Every action an agent takes is governed and logged — see Governed by design.

How OpenWorker works

Download

⬇ macOS (Apple Silicon) macOS 12+ · signed & notarized · auto-updates

⬇ Windows 10/11 (x64) builds are not yet code-signed, so SmartScreen will warn; signing is in progress

Open the app, add a model key (or point it at Ollama), and ask for something real.

Use cases

Pick a coworker, point it at real work, get a finished deliverable:

Specialist coworkers arrive with the tools, working style, and check-ins for one job already set up. Security coworkers ship first.

How it works

  1. Tell OpenWorker the outcome you want - "prepare a customer brief," "untangle my calendar," "draft a report," "check where the release stands across Jira and GitHub."
  2. It breaks the task into steps and works across your desktop, files, and connected apps.
  3. Before anything consequential - sending a message, changing a calendar, running a command - it checks in and you approve or redirect.
  4. You get the finished deliverable, not a to-do list.

Under the hood:

┌────────────────────────────────────────────────┐
│              OpenWorker desktop app            │  native shell + GUI
├────────────────────────────────────────────────┤
│           local agent server (Python)          │  engine · tools · connectors - built on aisuite
├───────────────┬────────────────┬───────────────┤
│  your files   │   your tools   │  your model   │  everything runs with your keys,
│  & terminal   │ 25+ connectors │  any provider │  on your machine
└───────────────┴────────────────┴───────────────┘

Governed by design

Governance is the architecture, not a plugin - the agent can't grant itself new permissions, and no prompt can talk it past a gate. Three tiers, all in this repo:

  1. Hard floors. A set of dangerous and irreversible operations is human-only, always. No mode - including full auto-approve - lowers these floors; they always escalate to you.
  2. A ladder of earned autonomy. Actions are approval-gated by default. One-off approvals can graduate into standing rules, then into config allowlists - each step explicit, visible, and revocable. In auto-approve mode a reviewer model lets routine actions through and escalates anything it isn't sure about to you; repeated denials trip a circuit breaker that pauses the reviewer and hands control back. Reviewer verdicts are judgments, not guarantees - the floors and the audit trail are what backstop them.
  3. An audit trail that answers "who did this, and why?" Every tool call is recorded with its approval provenance - auto-approved, user-approved, or denied, with the reviewer's reasoning attached - and persisted with the conversation.

Unattended runs never self-approve: their asks park in an inbox until a human answers. Found a vulnerability? See SECURITY.md.

What it can do

Bring your own model

Model access is yours: pick a provider, paste your key, switch anytime. Supported out of the box:

OpenAI · Anthropic · Google Gemini · BytePlus Ark · Volcengine Ark Agent Plan · Inkling (Thinking Machines) · GLM (Z.ai) · DeepSeek · Kimi (Moonshot) · Qwen · MiniMax · Mistral · Grok (xAI) - plus open-weight models via Together and Fireworks, and fully local models via Ollama.

A curated model list marks what we've verified for tool-calling work. Adding any model string works at your own risk.

Privacy

OpenWorker is local-first. Everything lives on your machine: the agent loop, your conversations, connector tokens, and model keys - all in the app's local secret store. The only cloud piece is a small service that brokers OAuth handshakes for connectors. You can always use the App without signing-in - use the connectors via manually-created credentials/API-keys.

Run from source

Prerequisites: Python 3.10+, Node 20+, and (for the desktop shell) the Rust toolchain via rustup.

git clone https://github.com/andrewyng/openworker
cd openworker

# 1. One-time bootstrap - creates the Python venv at .venv
#    (on Windows, run from Git Bash or WSL)
bash packaging/setup_dev_env.sh

# 2. Start the local agent server
.venv/bin/openworker-server --cwd ~/some/project --port 8765
#    (Windows: .venv\Scripts\openworker-server.exe)

# 3. In a second terminal, start the UI
cd surfaces/gui
npm install
npm run dev        # browser UI on the Vite dev port

The standalone server creates a per-launch token at <state-dir>/sidecar-8765.token; Vite reads that user-only file when it starts. For direct API calls, send its value in the X-OpenWorker-Token header. The desktop app uses an in-memory launch token instead and never writes it to disk.

To run the full desktop app instead of the browser UI, replace step 3 with npm run tauri dev (from surfaces/gui/) - the Tauri shell launches the window and supervises the server itself.

Tests: .venv/bin/pytest (server), npm test and npm run e2e in surfaces/gui (GUI unit + hermetic end-to-end). Desktop bundles are built with packaging/build_dmg.sh / packaging/build_windows.ps1.

Repository layout

Directory What's in it
coworker/ Python backend - agent engine, model providers, connectors, MCP client, memory, automations
surfaces/gui/ Desktop app - React UI + Tauri shell that supervises the server
stt/ Speech-to-text sidecar (Rust) for voice input
packaging/ Installer builds (macOS DMG, Windows), auto-update manifest, dev bootstrap
docs/ Design specs and decision logs
tests/ Backend test suite

Built on aisuite

OpenWorker's engine is built on aisuite, a lightweight Python library providing a unified chat-completions API across LLM providers and an agents layer with tools, toolkits, and MCP support. If you want to build your own agent harness rather than use ours, start there; this repo is a working reference for what aisuite can carry.

OpenWorker was originally developed inside the aisuite repository before moving to its own home here; thanks to the aisuite contributors whose work it builds on.

Contributing

Contributions and bug reports are welcome - open an issue or a pull request. The app updates itself, so fixes reach installs quickly. For any PR, please attach screenshots of what was broken and how it is fixed now. We will shortly add features that you can contribute to. Please note that we are actively developing based off a internal list and goal, so we may not approve PRs that add features that are already under-development or deviates from our vision.

License

MIT - see LICENSE.

openworker (andrewyng/openworker)

Searching Database…

18.6K ·GitHub
Openworker
Что это такое?OpenWorker — это ИИ-помощник для работы с открытым исходным кодом, который живёт на вашем компьютере и выдаёт готовый результат, а не просто ведёт переписку: проверенный код с исправлениями, аккуратные документы, ответы в Slack с реальными цифрами, разобранная почта.
Это просто чат-бот или он реально выполняет задачи за меня?Это агентное десктопное приложение: вы описываете нужный результат, оно разбивает задачу на шаги и работает с вашими файлами и подключёнными приложениями, сверяясь с вами перед любым важным действием, и отдаёт готовый результат, а не ответ или список дел.
Как это запустить?Скачайте подписанную сборку для macOS (Apple Silicon, macOS 12+) или Windows 10/11 (x64), откройте приложение, добавьте ключ API модели или укажите Ollama и попросите что-нибудь реальное. Также его можно запустить из исходников с Python 3.10+, Node 20+ и набором инструментов Rust.
Каких провайдеров ИИ можно использовать вместе с ним?Вы используете собственный ключ для OpenAI, Anthropic, Google Gemini, DeepSeek, Kimi, Qwen, MiniMax, Mistral, Grok, моделей с открытыми весами через Together/Fireworks или полностью локальной работы через Ollama — привязки к одному провайдеру нет.
Готова ли сборка для Windows к использованию прямо сейчас?Она работает, но пока не подписана цифровым сертификатом, поэтому при открытии Windows SmartScreen покажет предупреждение, пока идёт подписание; сборка для macOS уже подписана и прошла нотаризацию.
Можно ли запустить это на Linux или только на Mac и Windows?Предлагаются только загрузки для macOS (Apple Silicon, macOS 12+) и Windows 10/11 (x64); Linux в списке поддерживаемых сборок не указан.
Как OpenWorker сам не даёт себе сделать что-нибудь вредное?Набор опасных необратимых операций составляет «жёсткие ограничения», которые может подтвердить только человек, и их не обходит ни один режим, включая auto-approve. Обычные действия проходят по лестнице: от разовых подтверждений к постоянным правилам и далее к спискам разрешённых действий в конфигурации; каждый вызов инструмента логируется с указанием источника подтверждения и обоснованием.
Может ли он работать внутри Slack, а не в своём окне приложения?Да — упомяните @OpenWorker в канале Slack, на вашем компьютере откроется сессия с использованием подключённых инструментов, а готовый ответ вернётся ответом в треде.
Что такое aisuite и зачем о нём упоминается в README?aisuite — это лёгкая библиотека на Python, которая предоставляет единый API chat completions и слой агентов и инструментов для разных провайдеров LLM. Движок OpenWorker построен на её основе, а сам проект изначально появился внутри репозитория aisuite, прежде чем переехать в собственный репозиторий.
С какими инструментами и приложениями он может работать из коробки?25+ интеграций, включая GitHub, Slack, Jira, Notion, Linear, HubSpot, Outlook, monday.com, Gmail и Google Calendar, а также ваш терминал и локальные файлы; любой дополнительный инструмент подключается через MCP.
What are similar projects?laya, starnet, taskuary, evenfire, brigade, open-swe, openfang, opensquilla
Which topics is it in?jira, notion, governance, assistant, slack, code-review, tauri, workflow-automation, ollama, security-tools, gemini, anthropic
Creator
andrewyng
Size
6 MB
Stars
18.6K
Updated
CommitOct 17Releasev0.3.1Oct 05
Age
2mo
Commits · 90 Days