- Category
- AI Agents
- Rank
- No. 3092Tools index
Previous survey · No. 2972 ·
- Pricing
- Freemium
- Type
- APP
- Use case
- Agent Building
- Interfaces
- Desktop
- Builder
- holaboss-ai
- GitHub
- 11.4k stars
- Latest release
- latest
- Date
About
holaOS is an Electron desktop workspace for running AI agents side by side, including Claude Code, Codex, and its own built-in agent. All agents share a local-first memory stored as plain files on disk and reach the same set of connected services through OAuth integrations and MCP servers. Beyond a chat pane it renders real interactive app surfaces, and a marketplace supplies additional apps and skills.
What it does
holaOS is a local application you install on your own computer that puts third-party tools, such as Notion or a browser, on screen next to a coding assistant, so the assistant works inside the real program while you watch and take over. It also links chat platforms like Slack, Feishu and WeChat, runs scheduled jobs, and saves outputs as spreadsheet, slide and Word documents. Models come from a bundled account (Kimi, GLM, GPT, Claude) or from keys you supply for any OpenAI- or Anthropic-compatible endpoint.
Why it's ranked here
The scope is real and the code backs it. The repository is a typed monorepo with separate packages for the runtime server, a process host that launches each assistant, a state store with vector search over saved context, and a published software kit for building add-on apps. Several of those packages carry their own test commands, and an end-to-end test command exists for the shell. The catch is the license: a modified Apache 2.0 that forbids offering it as a hosted service or bundling it into a sold product without written permission.
What's good
Security defaults are considered. The runtime server binds to the loopback address unless an operator overrides it, and a comment says so explicitly, which keeps the local service off the network by default. Crashes in background workers are logged before exit rather than lost. Connecting a remote tool server opens the system browser for consent and stores the token in the workspace. The add-on kit gives builders one declarative call to define a template, its tables and dashboards, while the framework handles the database writes inside a single transaction.
Tradeoffs
The license is the first thing to check. Internal use inside one organization is free, but hosting it for others or embedding it in a commercial product needs a paid license, contributors grant the producer the right to tighten the terms later, and the logo cannot be removed from the interface. Setup is heavy: Node 24 or newer, the Bun package manager, and a native SQLite build. The suggested one-line install pipes a remote script into the shell. Development launch needs a graphical session and may fail on a headless machine.
How to use it well
Fit: a team that wants several coding assistants sharing one set of connections and saved context on its own hardware, with no copy on a vendor server. Start with the installer without the launch flag, which stops after a type check so you can confirm the build before opening the window. Use your own provider keys if policy requires inference under your contracts. Read the license before any customer-facing deployment. It is not a fit for anyone planning to resell or host it as a service.
Technical notes+
package.json declares a Bun 1.3.6 plus Turbo monorepo requiring Node 24 or newer, with workspaces for runtime/api-server, runtime/harness-host, runtime/harnesses, runtime/state-store and runtime/channel-gateway, and trusts native dependencies such as better-sqlite3 and electron. runtime/api-server/src/index.ts listens on port 3060 by default and on 127.0.0.1 unless SANDBOX_RUNTIME_API_HOST is set, with a 2 second shutdown race. runtime/harness-host/src/index.ts is a CLI with discover-models, test-connection (45 second default timeout) and authorize-mcp subcommands. runtime/state-store/src/index.ts exports memory embedding and vector search record types. packages/app-builder-sdk/src/index.ts exports createApp, startMcpServer and SqliteStateBackend; docs/plugin-sdk.md documents defineTemplate.
Observed
- License
- Modified Apache 2.0; commercial license required for hosted or embedded commercial use (LICENSE)
- Language
- TypeScript, Bun and Turbo monorepo, Node 24 or newer (package.json)
- Platforms
- Electron desktop app for macOS (Apple Silicon and Intel), Windows and Linux per README badge
- Install
- Shell installer for macOS, Linux and WSL that can provision git and Node (INSTALL.md)
- Network default
- Runtime API server binds to 127.0.0.1 by default (runtime/api-server/src/index.ts)
- Interfaces
- App-builder SDK that can start an MCP server (packages/app-builder-sdk/src/index.ts)
- Tests
- Per-package test scripts for runtime packages and a desktop e2e script (package.json)
- Security policy
- Private vulnerability reporting by email (SECURITY.md)
Read from README.md, package.json, LICENSE, INSTALL.md, SECURITY.md, runtime/api-server/src/index.ts, runtime/harness-host/src/index.ts, runtime/state-store/src/index.ts, packages/app-builder-sdk/src/index.ts, docs/plugin-sdk.md.
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.