Hivemind

HiveMind OS

Your AI agent. Your machine. Your rules.

Documentation | Download | Quickstart | Installation | Plugin Development

---

HiveMind OS is a privacy-first desktop AI agent and automation platform. It runs on your machine, connects to the models and tools you choose, and helps you build reusable personas, workflows, and background bots without handing over all of your data to a hosted SaaS.

If you want to use HiveMind OS, start with the hosted docs at hivemind-os.io. If you want to build or contribute, this repository contains the Rust workspace, desktop app, CLI, SDK packages, and documentation source.

Why HiveMind OS

• Local-first - keep conversations, automations, and knowledge close to your machine
• Privacy-aware - data classification and outbound channel rules help prevent accidental leaks
• Model-flexible - use OpenAI, Anthropic, GitHub Copilot, Ollama, Azure, OpenRouter, and local runtimes
• Automation-ready - create personas, workflows, bots, scheduled jobs, and MCP-powered toolchains
• Extensible - add custom tools and plugins without rewriting the core app

Documentation

The repo contains the docs source in docs-site/, but the best entry point is the hosted site:

| Need | Link | |---|---| | Docs home | hivemind-os.io | | Installation | Installation Guide | | First setup | Quickstart | | Core concepts | How It Works | | Personas and workflows | Guides | | Plugin authors | Plugin Development Docs |

What's in this repo

| Path | Purpose | |---|---| | apps/hivemind-desktop/ | Tauri + SolidJS desktop application | | crates/ | Rust workspace for the daemon, API, CLI, models, tools, memory, and agent runtime | | packages/plugin-sdk/ | TypeScript SDK for HiveMind plugins | | packages/plugin-registry/ | Published plugin catalog metadata | | docs-site/ | VitePress source for the hosted documentation site | | tests/ | Workspace-level integration and support tests |

Developer quick start

Prerequisites

• Rust 1.85+
• Node.js 18+
• npm or pnpm
• Tauri CLI v2 for desktop development

Build and run

# Build the Rust workspace
cargo build --workspace

# Run the workspace tests
cargo test --workspace

# Build the desktop frontend
cd apps/hivemind-desktop
npm install
npm run build

Common dev commands

# Run the desktop app in development mode
cargo tauri dev

# Run the daemon directly
cargo run -p hive-daemon

# Explore the CLI
cargo run -p hive-cli -- --help

Architecture at a glance

HiveMind OS is organized around a local daemon with multiple clients and extension points:

• Desktop app for interactive chat, setup, workflows, and model management
• Rust services for orchestration, security policies, model routing, MCP, scheduling, and knowledge storage
• CLI and API for automation and operational control
• Plugin and MCP layers for connecting outside tools and services

License

MIT - see [LICENSE](./LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hivemind-os
• Source: hivemind-os/hivemind
• License: MIT
• Homepage: https://hivemind-os.io

Install and usage instructions live in the source repository linked above.