holaOS

<p align="center">
  <img src="docs/images/banner.png" alt="holaOS" />
</p>

<p align="center">
  <a href="https://trendshift.io/repositories/25964?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-25964" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/25964" alt="holaboss-ai%2FholaOS | Trendshift" width="250" height="55"/></a>
</p>

<p align="center"><strong>The Agentic Workspace Where Your Apps and Your Agent Sit Side by Side</strong></p>

<p align="center">
  Every company works differently. HolaOS is the workspace you shape to fit — connect the systems and chat tools you already run, add the skills and apps your team needs, run any model or agent. Set up in clicks, not months. Local-first, so none of it leaves your machines.
</p>

<p align="center">
  <a href="https://github.com/holaboss-ai/holaOS/actions/workflows/ci.yml"><img src="https://github.com/holaboss-ai/holaOS/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
  <img src="https://img.shields.io/badge/platform-macOS%20%28Apple%20Silicon%20%2B%20Intel%29%2C%20Windows%2C%20Linux-43853d" alt="macOS (Apple Silicon and Intel), Windows, and Linux supported" />
  <img src="https://img.shields.io/badge/desktop-Electron-47848f" alt="Electron desktop" />
  <img src="https://img.shields.io/badge/runtime-TypeScript-3178c6" alt="TypeScript runtime" />
  <img src="https://img.shields.io/badge/license-Modified%20Apache%202.0-0f7ae5" alt="Modified Apache 2.0 license" />
</p>

<p align="center">
  <a href="https://x.com/Holabossai"><img src="https://img.shields.io/badge/Follow%20on%20X-000000?style=for-the-badge&logo=x&logoColor=white" alt="Follow on X" /></a>
  <a href="https://discord.com/invite/NSeHUCBj6"><img src="https://img.shields.io/badge/Join%20our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join our Discord" /></a>
</p>

<p align="center">
  <a href="https://www.holaos.ai/?utm_source=github&utm_medium=oss&utm_campaign=hola_boss_oss&utm_content=readme_nav_website">Website</a> ·
  <a href="https://www.holaos.ai/docs/getting-started?utm_source=github&utm_medium=oss&utm_campaign=hola_boss_oss&utm_content=readme_nav_docs">Docs</a> ·
  <a href="https://www.holaos.ai/signin?utm_source=github&utm_medium=oss&utm_campaign=hola_boss_oss&utm_content=readme_nav_signin">Sign in</a> ·
  <a href="#quick-start">Quick Start</a>
</p>

<p align="center"><strong>⭐ If holaOS is useful, a star helps more builders find it.</strong></p>

<p align="center">
  <img src="docs/images/desktop-workspace.png" alt="holaOS desktop workspace" width="1280" />
</p>

---

## ✨ Why HolaOS is different

Most agent products hand you a finished product and hope it fits your work. HolaOS hands you the parts. Apps, chat tools, skills, integrations, models, agents, memory — you assemble the workspace around how your work actually runs, and change it whenever the work changes. Because everything runs locally, customizing it never means handing your work to someone else's cloud.


### 🪟 HolaApps — apps and agent, side by side

Install apps from the in-workspace marketplace and they open as **real, interactive surfaces right beside your agent.** Watch it work inside the app, step in whenever you want, and the result lands in place — not a wall of chat text, but the actual app, driven by the agent, next to the agent.

- **Real surfaces, not chat** — every app is a live UI (Notion, a browser, your own app), not a transcript.
- **Side-by-side by design** — app and agent share the screen, so you always see what's happening and can take over.
- **One click to install** — browse the in-workspace marketplace and open any app instantly.
- **Bring your own** — point a HolaApp at any URL and MCP server; it lives on your machine, yours to open and drive.
- Context stays in sync both ways — drive the app by hand and the agent keeps up. Whatever you click, type, or open in the UI becomes context the agent already has, so you never stop to re-explain what you just did.

<p align="center">
  <img src="docs/images/hola-app-example.png" alt="The Notion HolaApp open side-by-side with the agent navigating it in holaOS" width="1280" />
</p>

### 💬 IM — plug in the chat tools your team already lives in

Most work context never makes it into a document. It's in a Slack thread, a Feishu group, a DingTalk message. Connect the chat tools your team already uses and your agent works from the real conversation — not from your summary of it.

- **Where the context really is** — decisions, requirements, and changes get made in chat and stay there. The agent reads them directly, so you stop re-explaining what was already said.

- **The tools your team is already in** — Slack, Feishu, DingTalk, WeChat. Connect the ones you use, skip the ones you don't.

- **You decide what it can see** — access is granted per tool and per scope, and the agent reads nothing until you approve it.

### 🧩 Skills, integrations, and MCP — add any capability without building one

- **Integrations** — connect Gmail, Notion, Slack, GitHub, Linear and 50+ more with one-click OAuth. Agents read and act across your tools, no glue code — and every agent inherits the same connections.
- **MCP** — plug in any Model Context Protocol server to give your agents new tools. Bring your own, or install community MCP servers in one click.
- **Skills** — package a workflow once; any agent runs it on demand.
- **Combos** — bundle skills and integrations into a single one-click install.

<p align="center">
  <img src="docs/images/marketplace.png" alt="The holaOS in-workspace app marketplace" width="1280" />
</p>

### 💸 Models your way — pick the right one per task, or bring your own

One account, every model — no keys, no setup, no switching between providers. The latest frontier models are **built in**: cost-efficient **Kimi K3** and **GLM 5.2** for everyday volume, plus top-tier **GPT 5.6**, **Claude Opus 5**, and **Fable 5** for the hard problems. Prefer your own provider? **Bring your own keys** for OpenAI, Anthropic, or any OpenAI- or Anthropic-compatible endpoint — those run on _your_ account, not your holaOS plan.

- **Zero-setup default** — one account, every SOTA model, no API keys to manage.
- **BYOK when you want it** — your keys, your providers, your rates.
- **Right model per task** — pick per job, per agent.


### 🔀 Agents — run the agent you prefer, not the one we picked

Claude Code, Codex, and the built-in holaOS agent — side by side, no switching. Whichever you run, it shares the same memory, tools, skills, and apps. Use the best agent for the job without rebuilding your setup every time.

- **No lock-in** — run Claude Code, Codex, or holaOS's own agent in the same workspace, over the same tools, files, and memory.
- **Shared everything** — one context, one set of tools, one workspace.
- **Consistent results** — the same skills and integrations, whatever's driving.

### 🧠 One memory, every agent

Context, preferences, and project history live in a single shared memory — stored **locally, as plain files you can read and edit.** Switch agents, close the app, come back next week: it already knows where you left off.

- **Never start from zero** — durable memory across sessions _and_ agents.
- **Local-first & yours** — on your machine, visible and editable, not locked in someone else's cloud.
- **Actually recallable** — structured and embedded, so the right context returns when it's needed.

<p align="center">
  <img src="docs/images/memory.png" alt="holaOS memory tree" width="1280" />
</p>


### 🛠️ Your entire workstation, agent-operable

- **🌐 A real browser, driven by agents** — signed-in browsers your agents drive to browse, click, and extract — under your control.
- **🎨 Frontier generation built in** — the latest image, video, and audio models inside every agent. Storyboard a video, design a poster, voice a script — one prompt.
- **📄 Real deliverables** — reports, spreadsheets, and slides saved as real `.xlsx`, `.pptx`, and `.docx` files you can send, not text stuck in a chat.
- **⏰ Automation** — run on a schedule or a trigger. Digests, monitors, and reports finish and file themselves.

### 🔒 Your work stays on your side

 An agent that can reach your tools, your chats, and your whole machine only makes sense if you stay in control of it. That control is built into how HolaOS works, not bolted on as a setting.

 - **Local-first, not cloud-first** — workspace files, memory, embeddings, and session history all live on your own disk. There is no copy of your work on our servers.

 - **We can't see your data** — not your files, not your memory, not your conversations. It isn't a policy we promise; it's a place your data never goes.

 - **Every action is approved by you** — connecting a tool, reading a thread, editing a file. The agent asks first, and you decide what it can reach and what stays off limits.

 - **Visible and reversible** — open what the agent remembers, edit it, delete it. Memory is a folder you can read, not a black box.

 - **Your own keys, your own contracts** — route inference through your own model provider if that's what your policy requires.

### 🌐 HolaHub — the recipe platform for agents, inside HolaOS


 The fastest way to set up your workspace is to start from someone else's working setup. On HolaHub, creators publish agent recipes that already run — model, prompt, skills, MCP, integrations — and anyone installs one in a click and gets the same result. Share what you built, run what other people built.

 - **One click to share** — package any run in HolaOS and post it to the Hub, process and result together. No export, no rewrite, no second account.

 - **One click to reproduce** — every skill, MCP, image, or video on the Hub runs in your own workspace instantly. Discovery and installation are the same gesture.

 - **Recipes, not just outputs** — each post opens up into how it was made: the session behind a skill