Hive 1.0

Tu propio equipo de agentes de IA, corriendo en tu computadora o tu servidor — no alquilado a una nube ajena. Hive coordina un enjambre de agentes especializados (investigación, archivos, código, documentos de oficina, automatizaciones cron, APIs) que trabajan para vos desde WhatsApp, Telegram, Slack, Discord o el navegador, mientras los ves operar en vivo en un mapa 3D.

La instalación son 2 comandos de terminal; de ahí en más un asistente visual configura todo — no hace falta tocar código para usarlo día a día. Si además programás, tenés un runtime local-first, multi-canal y open source completo para construir encima.

_{La Oficina 3D en /office: cada hexágono es un agente real, en vivo, no una animación de marketing.}

Hive reemplaza el patrón de "un agente gigante con 80 herramientas cargadas de memoria" por un coordinador liviano que descubre capacidades bajo demanda, delega en un catálogo de agentes persistentes y evalúa el resultado antes de darlo por bueno. Cada delegación queda respaldada por criterios de aceptación, checks determinísticos y evidencia auditable (proof packets): no confíes en el LLM a ciegas, compruébalo.

✨ Por qué Hive

• Catálogo persistente, no plantillas desechables. 8 agentes especializados (investigación web, navegador, archivos, ingeniería de software, Office, automatizaciones cron, APIs y A2UI) enrutan el trabajo según el objetivo. Para MCP, el coordinador pide autorización y crea especialistas persistentes por servidor.
• Carga mínima + descubrimiento bajo demanda. Cada turno arranca con 7 herramientas esenciales; search_knowledge incorpora el resto (57 herramientas, 25 skills) solo cuando la tarea lo necesita.
• Aceptación explícita, no confianza ciega. Cada entrega pasa por checks determinísticos y el juicio del coordinador antes de reportar éxito; si no cumple sus criterios, vuelve al mismo worker con feedback concreto (task_revise) sin repetir el trabajo desde cero.
• Ejecución durable. Jobs, leases y reintentos con backoff sobreviven caídas y reinicios del gateway — nada se pierde a mitad de camino.
• Multi-canal de verdad. Webchat, Telegram, Discord, Slack y WhatsApp corren sobre el mismo runtime y el mismo coordinador.
• Local-first. Tus datos viven en ~/.hive. Elige proveedores locales (Ollama) o remotos, por agente.

🧠 Cómo funciona

Cada turno comienza con siete herramientas esenciales. El coordinador busca capacidades adicionales en HiveDB, selecciona un agente adecuado y delega una subtarea con criterios de aceptación. El agente recibe únicamente sus herramientas, skills, modelo, workspace y recursos autorizados. Cada entrega pasa por checks determinísticos y el coordinador la acepta, la corrige él mismo o la devuelve al worker con task_revise antes de sintetizar la respuesta final.

flowchart TD
    U["Usuario / canal<br/>web · Telegram · Discord · Slack · WhatsApp · CLI"] --> GW["Gateway<br/>HTTP + WebSocket"]
    GW --> CO["Coordinador"]
    CO --> DISC["search_knowledge<br/>descubrimiento bajo demanda"]
    CO --> AG["Agentes de catálogo"]
    CO --> TL["Herramientas nativas + MCP"]
    CO --> PP["Checks determinísticos<br/>+ proof packet"]
    AG --> DB[("HiveDB")]
    TL --> DB
    PP --> DB

    subgraph HD["Harness durable"]
        SCHED["jobs · leases · reintentos"]
    end
    GW --> HD
    HD --> DB

Loading

Profundiza en la arquitectura y el ciclo de ejecución.

🧰 Stack tecnológico

Capa	Tecnología
Runtime y lenguaje	Bun 1.3, TypeScript 7 — monorepo con workspaces
Backend / core	Gateway HTTP + WebSocket, Agent Loop, Tool Runtime, scheduler y resilience (harness durable)
Datos	HiveDB (@johpaz/hive-db) — motor de documentos propio, única fuente de verdad, sin SQLite/FTS5 paralelo
Frontend	React 18, Vite 8, Tailwind CSS 4, Radix UI, TanStack Query, Zustand, React Router 7
Visualización	React Three Fiber / drei (Office3D), Recharts
Integración externa	Model Context Protocol (@modelcontextprotocol/sdk) con hot reload y leases por ejecución
Proveedores de IA	Anthropic, OpenAI, Google Gemini, Groq, Ollama (local) — selección por agente
Mensajería	Telegram (grammY), Discord (discord.js), Slack (Bolt), WhatsApp (Baileys), Webchat
Documentos ofimáticos	docx, pdf-lib / pdfjs-dist, pptxgenjs, xlsx
Testing	bun test, Vitest

🚀 Capacidades

• Agentes de catálogo para investigación, navegación, archivos, software, Office, A2UI, automatizaciones cron y APIs; calendario y otras integraciones MCP usan especialistas persistentes aprobados por el usuario.
• Herramientas nativas para filesystem, web, cron, CLI, agentes, A2UI, Office y APIs.
• 25 skills incluidas y descubrimiento bajo demanda con search_knowledge.
• Proveedores locales y remotos, selección de modelo por agente y herencia desde el coordinador.
• Webchat, Telegram, Discord, Slack y WhatsApp.
• MCP con sincronización de herramientas, hot reload y leases por ejecución.
• Tareas durables, reintentos, proof packets, artefactos verificables y observabilidad causal.
• Panel interactivo basado en A2UI v0.9, reuniones y centro de mando Office3D.

El inventario generado tiene la lista exacta de herramientas, skills, agentes, versiones y exports públicos.

🖥️ Superficies visuales

La experiencia visual se divide en dos superficies sin solapamientos:

Ruta	Qué es	Para qué sirve
/office	Oficina 3D	Observar agentes, delegaciones y actividad en vivo
/a2ui	Panel interactivo	Formularios, dashboards, confirmaciones y resultados generados por agentes

El Canvas clásico y su ruta /canvas fueron retirados en la versión 1.0.

⚡ Inicio rápido

Requisitos para desarrollar desde el repositorio: Bun 1.3.x y Git.

Desde el repositorio

git clone https://github.com/johpaz/hive.git
cd hive
bun install
bun run hive start

El gateway escucha por defecto en 127.0.0.1:18790. En el primer arranque, hive start abre el asistente de configuración en el navegador: ahí se registra el modelo principal y el resto de la configuración inicial.

Instalación global

bun add --global @johpaz/hive-agents@1.0.1
hive start

Docker

docker run --name hive \
  -p 18790:18790 \
  -v hive-data:/root/.hive \
  johpaz/hive-agents:1.0.1

Consulta la guía de instalación para binarios, actualización y migración.

🧭 Comandos esenciales

hive start
hive status
hive chat
hive agents list
hive doctor
hive stop

La referencia del CLI describe todos los comandos disponibles.

🔒 Configuración y seguridad

Los datos viven en ~/.hive o en el directorio indicado por HIVE_HOME. Los secretos se cargan desde variables de entorno o HIVE_HOME/.env; no deben almacenarse en el repositorio.

Hive genera un token al primer arranque y lo guarda con permisos restringidos en HIVE_HOME/.auth_token. Toda API protegida acepta Authorization: Bearer <token>. La UI también puede habilitar credenciales de correo y contraseña.

• Configuración
• Seguridad
• Canales
• MCP

🛠️ Desarrollo

bun run lint
bun run test
bun run test:ui
bun run docs:check
bun run build

Antes de enviar cambios consulta CONTRIBUTING.md. La documentación completa está indexada en docs/README.md.

🔄 Migración a 1.0

Haz una copia de HIVE_HOME, instala 1.0.0 y ejecuta:

hive migrate
hive doctor

Los agentes de catálogo se reconcilian al arrancar. Los datos de usuario se conservan, mientras que las capacidades retiradas dejan de sembrarse. Revisa las incompatibilidades y equivalencias en CHANGELOG_v1.0.0.md.

📄 Licencia

MIT — hecho desde Colombia para el mundo.