GitHub - holaboss-ai/holaboss-ai: OSS core runtime and desktop workspace stack for Holaboss

OSS core runtime and desktop workspace stack for Holaboss - holaboss-ai/holaboss-ai

Summary

holaOS is an Electron-based desktop workspace written in TypeScript that runs AI agents locally alongside real applications and chat tools. It is positioned as a local-first alternative to cloud-hosted agent products: workspace files, memory, and embeddings stay on the user's machine rather than on a vendor's servers. The project ships under a modified Apache 2.0 license with additional commercial-distribution and branding conditions.

What it is useful for

holaOS is useful when an engineer wants one desktop surface where multiple agents can drive real applications instead of producing text-only transcripts. The README documents running Claude Code, Codex, and a built-in holaOS agent side by side, all sharing the same memory, skills, and connected tools.

Documented capabilities include:

• Integrations with Gmail, Notion, Slack, GitHub, and Linear plus others via one-click OAuth (the project claims 100+ integrations overall).
• MCP support, so any Model Context Protocol server can be added to extend agent tools.
• Skills and "Combos" for packaging reusable workflows that any agent can run.
• Built-in access to models such as Kimi K3, GLM 5.2, GPT 5.6, Claude Opus 5, and Fable 5, plus BYOK for OpenAI, Anthropic, or compatible endpoints.
• A real, signed-in browser the agent can drive, plus image, video, and audio generation.
• Real file deliverables such as .xlsx, .pptx, and .docx files instead of chat transcripts.
• Scheduled or trigger-based automation for digests, monitors, and reports.
• Per-tool, per-scope permission prompts, and memory stored as plain files on disk that the user can read and edit.

The README states the app is available for macOS (Apple Silicon and Intel), Windows, and Linux.

How engineers can use it

The README documents two paths.

One-line install on macOS, Linux, or WSL:

curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh | bash -s -- --launch

Manual install after verifying git --version, node --version, and npm --version (the repo pins Node in .nvmrc; running nvm use in the repo root picks it up automatically if you use nvm):

npm run desktop:install
cp apps/desktop/.env.example apps/desktop/.env
npm run desktop:prepare-runtime:local
npm run desktop:typecheck
npm run desktop:dev

A predev hook validates the environment and rebuilds native modules before Electron opens. The README notes that legacy desktop/.env files are still accepted but new setups should use apps/desktop/.env. Steps beyond this brief flow are not contained in the supplied README, so refer to the repository's INSTALL.md runbook for the full manual procedure. The modified Apache 2.0 license with extra commercial and branding terms is worth reviewing before redistributing internally.