selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

OpenWorkBuddy logo

Self-host OpenWorkBuddy

v0.17.7

Local-first AI office agent delivering real PPTX, DOCX, XLSX

BetaSource AvailableOther
Updated9 hours ago
LanguageJavaScript
Setup difficultyModerate
Stars
363
Port
3800 (HTTP server)
Install with Docker Compose
OpenWorkBuddy demo showing agent completing a real office task and delivering a fileOpenWorkBuddy creative canvas for image and video creation with Agent panelHunan travel guide website generated by OpenWorkBuddyBeijing 3-day trip plan with map view generated by OpenWorkBuddyTrip route opened in Google Maps from OpenWorkBuddy outputTrip timeline view from OpenWorkBuddy outputScheduled task result delivered to Feishu (Lark)AI short drama poster generated on the infinite canvasPhotorealistic image generation test: same person across four scenes

What is OpenWorkBuddy?

This local-first AI office agent accepts a natural language request plus your materials, then autonomously plans, executes using tools and skills, verifies the output, and hands back real editable files — PPTX presentations, DOCX documents, XLSX spreadsheets, and HTML pages — that you can open and inspect. It works with many model providers for local and cloud models, and can also use Claude Code or Codex CLI installed on your machine as the execution engine. The agent includes a visual infinite canvas for image and video creation, short-drama workflows, scheduled tasks with IM notifications (Feishu, WeChat, WeCom, DingTalk, Telegram), MCP connector support, and a Markdown-based skill system for extensibility. It runs as a desktop app (Electron) on macOS, Windows, and Linux, or can be deployed to a server via Docker for team use with multi-tenancy, RBAC, quotas, and audit logging. Personal non-commercial, academic, and non-profit use is free under the PolyForm Noncommercial 1.0.0 license; commercial use requires a paid license. No telemetry, no forced updates, and API keys stay in your local config.json.

Should you self-host OpenWorkBuddy?

OpenWorkBuddy scores 48/100 on selfhost.directory (how scoring works) and ranks #52 of 120 in AI Assistant. It has 363 GitHub stars.

It shipped 8 stable releases in the past year. The latest, v0.17.5, came out on 27 October 2026.

Setup is moderate: expect some configuration beyond a single command. It is Other-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is AionUi (81/100, 33 846 stars). It scores higher overall, so compare the two before you pick. See OpenWorkBuddy vs AionUi side by side.

Features

  • Agent evaluation framework
  • Built-in browser rendering
  • Diagram generation
  • Infinite canvas for image/video
  • Local-first architecture
  • Long-task auto-continueDisabled by default
  • MCP connector support
  • Multi-Model Support
  • Multi-tenancy with RBAC
  • Real file delivery
  • Scheduled tasks with IM notifications
  • Web preview with isolated storage

OpenWorkBuddy README

How to install OpenWorkBuddy

Install OpenWorkBuddy with Docker Compose

cp deploy/env.example .env # 端口、域名、数据目录都在这里改,不改也能起 docker compose up -d --build docker compose logs -f app # 看它起来没(服务名叫 app,容器名叫 openworkbuddy)

Single volume for all persistent data

How to configure OpenWorkBuddy

  • active_modelName of the currently active model

    Name of the currently active model

    values: String matching a model name

  • decideConfiguration for the Jev decision model

    Configuration for the Jev decision model

    values: JSON object with off, route, base_url, api_key, model

  • modelsArray of model configurations with name, provider, base_url, api_key, model

    Array of model configurations with name, provider, base_url, api_key, model

    values: JSON array of model objects

  • OPENWORKBUDDY_BIND127.0.0.1Host bind address for the server

    Host bind address for the server

    values: 127.0.0.1 or 0.0.0.0

  • OPENWORKBUDDY_DISABLE_GPUDisable GPU acceleration for Electron

    Disable GPU acceleration for Electron

    values: 1 to disable

  • OPENWORKBUDDY_HOME~/OpenWorkBuddy (Windows: C:\Users\你\OpenWorkBuddy)Data directory for config.json, accounts, sessions, output files, skills, backups

    Data directory for config.json, accounts, sessions, output files, skills, backups

    values: Any writable directory path

  • OPENWORKBUDDY_PORT3800Port the server listens on

    Port the server listens on

    values: Any valid port number

  • OPENWORKBUDDY_TRUST_PROXY0Number of proxy layers in front for correct client IP detection

    Number of proxy layers in front for correct client IP detection

    values: 0, 1, 2

  • PORT3800Port for the Node.js server (used when running via npm start)

    Port for the Node.js server (used when running via npm start)

    values: Any valid port number

  • providersAdditional provider configurations (e.g., typesafe for Jev)

    Additional provider configurations (e.g., typesafe for Jev)

    values: JSON array of provider objects

  • TZAsia/ShanghaiTimezone for scheduled tasks

    Timezone for scheduled tasks

    values: Any valid IANA timezone

OpenWorkBuddy releases & version history

More in Content Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…