# holaOS | holaboss.ai | Knowledge Base | Instagit

Open-source All in One AI agent workspace. Run any agent — Claude Code, Codex — across your tools (100+ integrations + MCP), apps, browser, and files, with shared memory. Built-in models or BYOK.

GitHub Stars: 7.3k

Repository: https://github.com/holaboss-ai/holaOS

---

## Articles

### [Configuration Files in the holaOS Apps Directory: Complete Reference Guide](/holaboss-ai/holaOS/what-are-configuration-files-in-holaos-apps-directory)

Explore holaOS apps directory configuration files including Vite, TypeScript, Wrangler, and TSUP configs. Understand building, bundling, and runtime behavior for docs and desktop apps.

- Tags: api-reference
- Published: 2026-08-15

### [Does holaOS Offer Code Refactoring Assistance?](/holaboss-ai/holaOS/does-holaos-offer-code-refactoring-assistance)

Discover how holaOS delivers code refactoring assistance using its Personal Intelligence runtime tools. Explore LLM-driven endpoints for automated code transformation and improve your codebase efficiently.

- Tags: how-to-guide
- Published: 2026-08-15

### [How to Get Support for holaOS: Community and Hosted Options Explained](/holaboss-ai/holaOS/how-to-get-support-for-holaos)

Find holaOS support solutions. Use GitHub issues for open-source bugs and runtime problems. Contact Holaboss AI directly for authentication, billing, and backend services.

- Tags: how-to-guide
- Published: 2026-08-15

### [How to Join the holaOS Community Forum: Discord Access Guide](/holaboss-ai/holaOS/is-there-community-forum-for-holaos)

Join the holaOS community on Discord to get support, share ideas, and collaborate with developers. Access the forum easily via the repository's invite links.

- Tags: getting-started
- Published: 2026-08-15

### [HolaOS Roadmap: A Complete Guide to Upcoming Features and Platform Improvements](/holaboss-ai/holaOS/what-is-roadmap-for-holaos)

Explore the holaOS roadmap for upcoming features and platform improvements. Discover UI fixes, automation, and advanced content formats detailed in the repository.

- Tags: roadmap
- Published: 2026-08-15

### [How to Use holaOS for Debugging: A Complete Guide to the Debug CLI](/holaboss-ai/holaOS/how-to-use-holaos-for-debugging)

Master holaOS debugging with the read-only debug CLI. Inspect SQLite runtime.db to troubleshoot agent sessions, cronjobs, and workspace state safely. Get our complete guide.

- Tags: how-to-guide
- Published: 2026-08-15

### [What Are the Main Features of holaOS? A Complete Guide to the Local-First Multi-Agent Workspace](/holaboss-ai/holaOS/what-are-main-features-of-holaos)

Explore the main features of holaOS, a local-first multi-agent workspace. Discover its Electron UI, TypeScript runtime, and HolaApps marketplace for seamless LLM agent collaboration.

- Tags: getting-started
- Published: 2026-08-15

### [How to Integrate holaOS with Your Existing Workflow: 3 Methods Explained](/holaboss-ai/holaOS/can-i-integrate-holaos-with-my-existing-workflow)

Integrate holaOS with your workflow using its Remote API, typed runtime client, or Channel Gateway. Discover three powerful methods for seamless integration and boost your productivity today.

- Tags: how-to-guide
- Published: 2026-08-15

### [How holaOS Handles Privacy: macOS Permissions and SSRF Protection](/holaboss-ai/holaOS/how-does-holaos-handle-privacy)

Discover how holaOS prioritizes privacy with robust macOS permissions management and advanced SSRF protection, safeguarding your data at both system and network levels.

- Tags: deep-dive
- Published: 2026-08-15

### [What AI Models Does holaOS Use? A Complete Technical Guide to the Model Routing System](/holaboss-ai/holaOS/what-ai-models-does-holaos-use)

Discover the AI models powering holaOS. Explore its flexible routing system supporting OpenAI GPT-5, Claude, Gemini, Ollama, and custom providers via a unified API.

- Tags: deep-dive
- Published: 2026-08-15

### [How to Set Up a Development Environment for holaOS: Complete Setup Guide](/holaboss-ai/holaOS/how-to-set-up-development-environment-for-holaos)

Easily set up your holaOS development environment. Run the automated installer script for Node 24+ and dependencies in one command. Get started with holaOS today.

- Tags: how-to-guide
- Published: 2026-08-15

### [Does holaOS Support Code Generation? AI-Driven Development Guide](/holaboss-ai/holaOS/does-holaos-support-code-generation)

Discover how holaOS enables AI driven code generation with OpenAI Codex and Claude Code. Learn how MCP integrates CLI tools and inserts generated files directly into your workspace.

- Tags: how-to-guide
- Published: 2026-08-15

### [holaOS License: MIT License Terms and Usage Rights](/holaboss-ai/holaOS/what-is-license-for-holaos)

Discover the MIT License terms for holaOS. Learn your rights to use, modify, and distribute the code freely. Understand holaOS usage.

- Tags: licensing
- Published: 2026-08-15

### [How to Report a Bug in holaOS: Complete Guide to GitHub Issues and Security Disclosure](/holaboss-ai/holaOS/how-to-report-a-bug-in-holaos)

Learn how to report a bug in holaOS by submitting a GitHub issue. Find instructions for bug reports and security disclosures to help improve holaOS.

- Tags: how-to-guide
- Published: 2026-08-15

### [IDEs Compatible with holaOS: Complete Development Environment Setup](/holaboss-ai/holaOS/what-ides-are-compatible-with-holaos)

Discover IDEs compatible with holaOS for seamless development. Set up your environment with VS Code, WebStorm, Cursor, and Neovim. Works with any TypeScript/JavaScript IDE.

- Tags: getting-started
- Published: 2026-08-15

### [Where to Find holaOS Documentation: Official Guides and Developer Resources](/holaboss-ai/holaOS/where-can-i-find-holaos-documentation)

Find holaOS documentation easily. Access official guides, developer resources, and architectural specs on the holaOS website or in the GitHub repository.

- Tags: getting-started
- Published: 2026-08-15

### [How to Contribute to the holaOS Project: A Complete Developer Guide](/holaboss-ai/holaOS/how-to-contribute-to-holaos-project)

Learn how to contribute to the holaOS project. Set up your Node environment, choose a track, and submit PRs with Conventional Commits for a smooth developer experience.

- Tags: getting-started
- Published: 2026-08-15

### [holaOS System Requirements: Complete Guide for macOS, Linux, and Windows WSL](/holaboss-ai/holaOS/what-are-system-requirements-for-holaos)

Discover holaOS system requirements for macOS, Linux, and Windows WSL. Learn the minimal dependencies needed to run holaOS and get started quickly.

- Tags: getting-started
- Published: 2026-08-15

### [How to Customize holaOS: A Complete Guide to Desktop, Workspace, and Agent Extensions](/holaboss-ai/holaOS/can-i-customize-holaos)

Discover how to customize holaOS without forking the codebase. Tailor desktop, workspace, and agent extensions for a personalized OS experience. Start customizing today!

- Tags: how-to-guide
- Published: 2026-08-15

### [How the AI Coding Assistant Works in holaOS: A Deep Dive into the pi-coding-agent Architecture](/holaboss-ai/holaOS/how-does-ai-coding-assistant-in-holaos-work)

Discover how the pi-coding-agent architecture powers the AI coding assistant in holaOS. Explore the four-layer pipeline processing natural language requests for efficient code generation.

- Tags: deep-dive
- Published: 2026-08-15

### [holaOS Programming Language Support: What's Built-In and How to Extend It](/holaboss-ai/holaOS/what-programming-languages-does-holaos-support)

Discover holaOS programming language support. Built-in Markdown editor highlights 37 languages, with the platform written in TypeScript. Learn how to extend its capabilities.

- Tags: programming-language-support
- Published: 2026-08-15

### [Is holaOS Open Source? License, Source Code, and Self-Hosting Guide](/holaboss-ai/holaOS/is-holaos-open-source)

Discover if holaOS is open source. Explore its Apache 2.0 license, access the full source code on GitHub, and learn how to self-host holaOS for your needs.

- Tags: how-to-guide
- Published: 2026-08-15

### [What Is holaOS? A Local-First AI Workstation for Persistent Agent Collaboration](/holaboss-ai/holaOS/what-is-holaos)

Discover holaOS, a local-first AI workstation enabling seamless agent collaboration. Share memory, tools, and skills in a persistent workspace for efficient AI task management.

- Tags: getting-started
- Published: 2026-08-15

### [How holaOS Ensures Scalability for AI Workloads: 7 Architectural Mechanisms Explained](/holaboss-ai/holaOS/hollaos-ensure-scalability-ai-workloads)

Discover how holaOS ensures AI workload scalability with 7 architectural mechanisms. Learn how its modular, local-first design prevents memory and compute bottlenecks for peak performance.

- Tags: architecture
- Published: 2026-08-15

### [holaOS Entry Points and Interfaces: 5 Ways to Interact with the System](/holaboss-ai/holaOS/interfaces-entry-points-interacting-hollaos)

Explore the 5 main holaOS entry points and interfaces including Electron desktop, Runtime API, MCP host, hola CLI, and runtime packages. Interact with holaOS easily.

- Tags: api-reference
- Published: 2026-08-15

### [How to Set Up a Development Environment for holaOS: Complete Install Guide](/holaboss-ai/holaOS/setup-development-environment-hollaos)

Set up your holaOS development environment quickly. Follow our complete install guide to install git, Node 24+, clone the repository, and bootstrap your entire holaOS development environment in minutes.

- Tags: getting-started
- Published: 2026-08-15

### [Testing Strategies in holaOS: A Complete Guide to Monorepo Testing](/holaboss-ai/holaOS/testing-strategies-employed-hollaos)

Discover holaOS testing strategies, including unit integration and E2E tests, orchestrated by Turbo within its monorepo. Learn how to ensure robust code quality.

- Tags: how-to-guide
- Published: 2026-08-15

### [How HolaOS Handles Real‑Time AI Inference: Architecture, MCP Protocol, and Streaming Pipeline](/holaboss-ai/holaOS/hollaos-handle-real-time-ai-inference)

Discover how HolaOS manages real-time AI inference using its layered architecture, MCP protocol, and streaming pipeline for efficient token management and usage tracking.

- Tags: architecture
- Published: 2026-08-15

### [Best Practices for Developing with holaOS: A Complete Guide to the Monorepo Architecture](/holaboss-ai/holaOS/best-practices-developing-hollaos)

Master holaOS development with our guide to monorepo best practices. Learn wrapper patterns, ordered migrations, and agent architecture for efficient building.

- Tags: best-practices
- Published: 2026-08-15

### [How to Integrate Custom AI Models into HolaOS: A Complete Developer Guide](/holaboss-ai/holaOS/integrate-custom-ai-models-hollaos)

Integrate custom AI models into HolaOS with our developer guide. Learn how to register any provider and model using the model agnostic harness architecture without core code changes.

- Tags: how-to-guide
- Published: 2026-08-15

### [How HolaOS Manages Configuration Settings: A Layered Runtime System Explained](/holaboss-ai/holaOS/how-hollaos-manage-configuration-settings)

Discover how HolaOS manages configuration settings with its layered runtime system. Learn about JSON documents, environment variable overrides, and a three-layer precedence for flexible deployments.

- Tags: internals
- Published: 2026-08-15

### [What Is the Role of the `utils` Package in Hola OS?](/holaboss-ai/holaOS/role-utils-package-hollaos)

Discover the crucial role of the `utils` package in Hola OS. It centralizes shared helper functions for data formatting, string manipulation, and UI across the entire application.

- Tags: internals
- Published: 2026-08-15

### [Recommended Tools and Frameworks for holaOS Development: A Complete Step-by-Step Guide](/holaboss-ai/holaOS/tools-frameworks-recommended-hollaos-development)

Explore essential tools and frameworks for holaOS development including TypeScript, npm, Electron with React, and Tailwind CSS. Master your holaOS projects with this comprehensive guide.

- Tags: getting-started
- Published: 2026-08-15

### [How holaOS Handles User Authentication and Authorization: OAuth 2.0 Architecture Explained](/holaboss-ai/holaOS/hollaos-user-authentication-authorization)

Discover how holaOS handles user authentication and authorization using a centralized OAuth 2.0 architecture. Learn about its three-layer model for secure and efficient access management.

- Tags: architecture
- Published: 2026-08-15

### [What Dependencies Are Required to Run HolaOS? Complete Installation Guide](/holaboss-ai/holaOS/dependencies-running-hollaos)

Discover the essential dependencies for running HolaOS. Learn about root-level tooling, workspace packages, and desktop libraries needed for installation. Get started now!

- Tags: getting-started
- Published: 2026-08-15

### [How Is the API Structured in HollaOS? Server, Routes, and SDK Explained](/holaboss-ai/holaOS/api-structure-hollaos)

Explore the HollaOS API structure. Understand its Fastify-based RESTful API, route organization under /api/v1/, and the typed TypeScript SDK for seamless integration.

- Tags: api-reference
- Published: 2026-08-15

### [Does HolaOS Support Distributed AI Training? Architecture Analysis](/holaboss-ai/holaOS/hollaos-support-distributed-ai-training)

Discover if HolaOS supports distributed AI training. This architecture analysis reveals HolaOS is built for inference, not training, lacking any distributed training infrastructure.

- Tags: architecture
- Published: 2026-08-15

### [What Programming Languages Are Primarily Used in HolaOS? A Complete Technical Breakdown](/holaboss-ai/holaOS/programming-languages-used-hollaos)

Discover the primary programming languages powering HolaOS. Learn how TypeScript, JavaScript, Shell, and Rust contribute to its technical foundation.

- Tags: programming-languages
- Published: 2026-08-15

### [How to Contribute to holaOS Module Development: A Complete Guide for Building MCP-Compatible Extensions](/holaboss-ai/holaOS/contribute-development-hollaos-modules)

Contribute to holaOS module development. Fork holaboss-ai/holaOS, build MCP-compatible extensions with the SDK, and submit your pull request for review.

- Tags: how-to-guide
- Published: 2026-08-15

### [hollaOS Architecture: A Deep Dive into the Modular TypeScript Platform](/holaboss-ai/holaOS/architecture-hollaos-project)

Explore the hollaOS architecture a modular TypeScript platform. Understand its runtime state store, harness capabilities, channel gateway, and React UI for robust external integrations.

- Tags: architecture
- Published: 2026-08-15

### [What Natural Language Processing Packages Are Included in holaOS?](/holaboss-ai/holaOS/nlp-packages-hollaos)

Discover the six natural language processing NLP packages included in holaOS. Explore OpenAI, Anthropic Claude SDK, PI AI utilities, and more for your AI projects.

- Tags: api-reference
- Published: 2026-08-15

### [How holaOS Handles Data Processing and Management: A Deep Dive into the SQLite-First Architecture](/holaboss-ai/holaOS/how-hollaos-handle-data-processing-management)

Discover how holaOS manages data with its SQLite-first architecture. Learn about versioned databases, workspace isolation, and vector-powered search for efficient data processing.

- Tags: deep-dive
- Published: 2026-08-15

### [holaOS Core System Components: The 4 Pillars of a Local‑First Agent Runtime](/holaboss-ai/holaOS/key-components-hollaos-core-system)

Discover the 4 core pillars of holaOS: State Store, API Server, Channel Gateway, and Desktop Application. Learn how these components create a shared SQLite-backed workspace for AI agents.

- Tags: architecture
- Published: 2026-08-15

### [How to Integrate AI Models in HolaOS Packages: A Complete Code Guide](/holaboss-ai/holaOS/ai-model-integration-examples-hollaos-packages)

Discover how to integrate AI models in HolaOS packages with this complete code guide. Explore examples in runtime harnesses and request files for seamless integration.

- Tags: how-to-guide
- Published: 2026-08-15

### [What Is the Purpose of the `services` Package in holaOS?](/holaboss-ai/holaOS/purpose-of-services-package-hollaos)

Discover the purpose of the services package in holaOS. It provides a core abstraction layer for runtime APIs, enabling type-safe RPC calls for desktop apps, plugins, and more.

- Tags: internals
- Published: 2026-08-15

### [How Modules Are Organized in holaOS: A Complete Guide to the Monorepo Architecture](/holaboss-ai/holaOS/how-are-modules-organized-hollaos)

Discover how holaOS organizes modules within its Bun workspaces monorepo. Learn about the apps packages and runtime directories. Explore the architecture of holaboss-ai/holaOS.

- Tags: architecture
- Published: 2026-08-15

### [Core Packages in holaOS for AI Development: A Complete Guide to the Built-In AI Stack](/holaboss-ai/holaOS/what-are-core-packages-hollaos-ai-development)

Discover the eight core AI packages in holaOS, including OpenAI, Claude, and Pi-AI, that create a complete runtime environment for building and deploying AI agents. Get the full guide.

- Tags: deep-dive
- Published: 2026-08-15