Ein Stock für deine AI-Agenten.
A hive for your AI agents.
Jeder Mensch bekommt seinen eigenen persönlichen Agenten. Jedes Projekt bekommt seine gemeinsamen Arbeits-Agenten. Alles läuft auf deiner Hardware, 24/7 — egal, ob dein Laptop an ist.
Tip
Warum gibt es HydraHive? Aus einer einfachen Frage heraus: Warum muss mein Rechner laufen, damit die Familie einen Assistenten hat? Inzwischen ist daraus eine Plattform geworden, auf der Familien, Teams oder Einzelne ihr eigenes AI-Ökosystem bauen können — mit dem LLM ihrer Wahl, ohne Cloud-Vendor-Lock-in, mit eigenen Tools und eigenen Daten.
Warning
Das hier ist ein Bastelprojekt, keine Firma. HydraHive ist kein Produkt, keine Enterprise-Plattform, kein SaaS. Es ist ein Self-Hosted-AI-Backbone, der für meine Familie entstanden ist und jetzt auch für andere offen ist. Der Core ist stabil und läuft hier seit Monaten 24/7, aber Features wachsen schnell, Breaking-Changes passieren, Support ist Community-basiert (keine SLAs), Doku ist primär Deutsch und Englisch. Wer damit arbeiten will: herzlich willkommen. Wer etwas Enterprise-fertiges sucht: falsche Adresse — noch.
Persönlicher Agent pro User · Projekt-Agenten für Teams · Rollen, Permissions, Audit-Log · Composer für Agent-Prompts · eigenes Gedächtnis pro Agent
Anthropic · OpenAI · Claude Max OAuth · MiniMax · NVIDIA NIM · DeepSeek · Google · Ollama (lokal auf Server oder Workstation) · Fallback-Ketten
Shell · Dateien lesen/schreiben · Web-Search (SearXNG, kein Tracking) · Gedächtnis · Agent-zu-Agent-Calls · MCP-Server anbinden · Skills installieren · Hooks definieren · Sub-Agent-Worktrees · Permission-Layers · WKS-SSH
Web-Console (React) · Matrix · Discord · WhatsApp · Mail · Voice-Input · Token-Streaming mit Stop-Button
Dein persönlicher Agent kann via SSH auf deinem Rechner arbeiten (mit Approval) · Workstation-eigenes Ollama einbinden · Samba-Share · individueller SSH-Port
KVM/QEMU-VMs direkt verwalten — starten, stoppen, VNC-Konsole im Browser · ISO hochladen · Agenten können VMs via vm_create/vm_start/vm_stop steuern
Läuft auf deiner Hardware (Homelab · NAS · Proxmox-VM) · One-Click-Installer · Self-hosted, self-owned · Updates per Konsole · SSH Host-Key-Pinning für Target-Systeme
flowchart LR
User["👤 User<br/>Familie · Team"]
Browser["🌐 Web-Console<br/>(React)"]
Chat["💬 Chat-Apps<br/>Matrix · Discord · WhatsApp · Mail"]
Core["🧠 HydraHive Core<br/>FastAPI · Orchestrator · SQLite"]
Personal["🤖 Persönlicher<br/>Agent"]
Project["🤝 Projekt-<br/>Agent"]
LLMs["🎛️ LLM-Pool<br/>Claude · GPT · MiniMax<br/>NVIDIA · Ollama · ..."]
Tools["🛠️ Tools + Skills<br/>Shell · Memory · MCP · Hooks"]
Wks["🖥️ Workstation<br/>(per SSH, mit Approval)"]
User --> Browser
User --> Chat
Browser --> Core
Chat --> Core
Core --> Personal
Core --> Project
Personal --> LLMs
Project --> LLMs
Personal --> Tools
Project --> Tools
Personal -.-> Wks
classDef user fill:#F59E0B,stroke:#B45309,color:#fff
classDef ui fill:#6366F1,stroke:#4338CA,color:#fff
classDef core fill:#10B981,stroke:#047857,color:#fff
classDef agent fill:#EC4899,stroke:#BE185D,color:#fff
classDef infra fill:#0EA5E9,stroke:#0369A1,color:#fff
class User user
class Browser,Chat ui
class Core core
class Personal,Project agent
class LLMs,Tools,Wks infra
git clone https://github.com/hydrahive/hydrahive.git
cd hydrahive
sudo bash installer/install.sh
# → open https://<IP> → Setup-Wizard| Profil | GPU | LLM | Gut für |
|---|---|---|---|
| 🪶 Lite | nein | Cloud-APIs | VPS · Demo · Testing |
| 🦾 Full | ja (PCIe-Passthrough) | Ollama + Cloud | Produktion · volle Kontrolle |
Referenz-Setup: GTX 1080 Ti (11 GB VRAM) auf Proxmox-VM, Ubuntu 24.04. Läuft aber auch auf kleineren Setups.
| Dokument | Inhalt |
|---|---|
| 📖 Handbook | Installation, Getting started, alle Features |
| 🔧 Technical Docs | Architektur, Module, Data-Flow |
| 🔌 API Reference | Alle REST-Endpoints |
| 🛠️ Developer Guide | Tools, Skills, Endpoints, Console-Pages hinzufügen |
| 👥 Enduser-Handbuch | Für die Familie/das Team (DE) |
Core: Python 3.12 · FastAPI · LiteLLM · matrix-nio · Anthropic SDK Console: React 18 · TypeScript · Vite · Tailwind CSS Matrix: conduwuit (Rust, single binary, RocksDB) Search: SearXNG (nativ, kein Docker) Installer: Bash + systemd (kein Docker)
为家庭和团队构建的自托管 AI 智能体平台。
每个人都有自己的个人智能体，每个项目都有共享的协作智能体。全部运行在你自己的硬件上， 24/7 在线 — 不需要你的笔记本一直开着。
- 🤖 个人智能体 + 项目智能体 — 多用户、角色权限、审计日志
- 🧠 任意大语言模型（LLM） — Anthropic · OpenAI · Claude Max OAuth · MiniMax · NVIDIA NIM · DeepSeek · Google · Ollama（本地）
- 🛠️ 丰富的工具与技能 — Shell · 文件 · Web 搜索 · 记忆系统 · MCP 服务器 · Skills · Hooks
- 💬 多平台接入 — Web 控制台 · Matrix · Discord · WhatsApp · Mail · 语音输入
- 🖥️ 工作站集成 — 智能体可通过 SSH 在你的电脑上工作（需审批）
- 🏠 完全自托管 — 运行在你的硬件上（Homelab · NAS · Proxmox）· 一键安装 · 数据归自己
git clone https://github.com/hydrahive/hydrahive.git
cd hydrahive
sudo bash installer/install.sh
# → 打开 https://<IP> → 进入安装向导目前文档主要以英语和德语为主，见上方 Documentation 章节。
Warning
这是一个业余项目，不是商业产品。 HydraHive 最初是为了让家人有一个 24/7 在线的 AI 助手而构建的，目前开放给所有想自托管 AI 系统的人使用。核心功能稳定，但新功能迭代很快，接口可能会变动。
主要支持语言为德语和英语 — 中文 Issue 和 PR 非常欢迎，但维护者不是母语者，响应以英德为主。寻找企业级支持的用户请另寻他处。
Active development · Hobby project. Stable Core, Features wachsen schnell, Breaking-Changes passieren — im Changelog markiert. Kein kommerzieller Support, kein SLA. Issues und PRs willkommen auf Deutsch oder Englisch.