@johpaz/hive 1.7.2 → 1.7.7

package/README.md

@@ -17,42 +17,105 @@ Hive es un Gateway de IA Orquestado — un Enjambre de Agentes Especializados qu
 
 ---
 
+## Por dentro
+
+51.937 líneas de TypeScript. Sin frameworks de agentes. Sin LangChain. Sin abstracciones intermedias. Todo construido desde cero sobre Bun + SQLite.
+
+```
+Language          files     blank   comment      code
+─────────────────────────────────────────────────────
+TypeScript          434      7671      2683     51937   ← motor, gateway, canales, UI
+Markdown             45      2225         0      8233
+JSON                 15         5         0       575
+CSS                   1       141        29       450
+YAML                  2        35        11       197
+Shell                 2        14         5        61
+Dockerfile            1        19        10        38
+─────────────────────────────────────────────────────
+TOTAL               504     10119      2741     61546
+```
+
+La imagen Docker pesa ~120 MB. El bundle npm pesa ~12 MB. El binario standalone ~50 MB. Todo el runtime cabe en una Raspberry Pi Zero 2W con 512 MB de RAM.
+
+---
+
 ## Instalación
 
+### Prerequisito — Bun
+
+Hive requiere [Bun](https://bun.sh) como runtime para las opciones de binario y npm. Docker no lo requiere.
+
+```bash
+curl -fsSL https://bun.sh/install | bash
+source ~/.bashrc   # o reinicia la terminal
+bun --version      # verifica que quedó instalado
+```
+
+---
+
 Elige la opción que mejor se adapte a tu caso:
 
-| | Docker | Binario | npm |
+| | Docker | Binario | npm / bun |
 |---|---|---|---|
-| Requiere | Docker | Nada | Node o Bun |
-| Setup | 1 comando | descarga + ejecuta | `npm install -g` |
-| Ideal para | servidores, VPS | uso personal | desarrolladores |
-| Tamaño | ~120 MB imagen | ~50 MB | deps en node_modules |
+| Requiere | Docker | Bun | Bun |
+| Setup | 1 comando | descarga + ejecuta | `bun install -g @johpaz/hive` |
+| Actualizar | `docker compose pull` | descarga nueva versión | `bun install -g @johpaz/hive` |
+| Ideal para | Raspberry Pi, VPS, laptop vieja, VM | uso personal, USB | desarrolladores |
+| Abre navegador | automático (con GUI) / por IP (headless) | automático | automático |
+| Tamaño | ~120 MB imagen | ~50 MB | ~12 MB bundle |
 
 ---
 
 ### Opción 1 — Docker (Recomendada para servidores y VPS)
 
-La forma más rápida. Un solo comando, sin instalar nada más.
+La forma más rápida. Sin instalar Node, Bun ni dependencias. Solo necesitas Docker.
+
+#### Laptop, PC o VM con interfaz gráfica
+
+Un solo comando que levanta todo y abre el navegador automáticamente:
 
 ```bash
-docker run -d \
-  -p 18790:18790 \
-  -v ~/.hive:/root/.hive \
-  --name hive \
-  --restart unless-stopped \
-  johpaz/hive:latest
+curl -O https://raw.githubusercontent.com/johpaz/hive/master/docker-compose.yml
+curl -O https://raw.githubusercontent.com/johpaz/hive/master/hive-docker.sh
+chmod +x hive-docker.sh
+./hive-docker.sh
 ```
 
-Luego abre **http://localhost:18790** — el setup web se abre automáticamente en la primera ejecución.
+El script levanta el contenedor, espera a que el gateway esté listo y abre el navegador directamente en `/setup` (primera vez) o en el dashboard (si ya está configurado).
 
-**Con Docker Compose** (recomendado para gestionar el ciclo de vida):
+#### Raspberry Pi, VPS o servidor headless
+
+Sin interfaz gráfica, usa Docker Compose directamente:
 
 ```bash
-curl -O https://raw.githubusercontent.com/johpaz/hive/main/docker-compose.yml
+curl -O https://raw.githubusercontent.com/johpaz/hive/master/docker-compose.yml
 docker compose up -d
 ```
 
-El archivo `docker-compose.yml` ya incluye el volumen de persistencia y el reinicio automático.
+Luego accede desde cualquier equipo en la misma red usando la IP del servidor:
+
+```
+http://<ip-del-servidor>:18790
+```
+
+Para conocer la IP del servidor:
+
+```bash
+ip a | grep "inet " | grep -v 127.0.0.1
+```
+
+> **Raspberry Pi tip:** si usas el mismo Pi para todo, `http://raspberrypi.local:18790` suele funcionar sin necesitar la IP.
+
+**Con un solo comando** (sin Compose):
+
+```bash
+docker run -d \
+  -p 18790:18790 \
+  -v hive-data:/root/.hive \
+  --name hive \
+  --restart unless-stopped \
+  johpaz/hive:1.7.7
+```
 
 **Variables de entorno disponibles:**
 
@@ -63,84 +126,191 @@ El archivo `docker-compose.yml` ya incluye el volumen de persistencia y el reini
 | `HIVE_AUTH_TOKEN` | — | Token de autenticación (opcional) |
 | `HIVE_LOG_LEVEL` | `info` | Nivel de logs (`debug`, `info`, `warn`, `error`) |
 
-**Persistencia:** todos los datos (DB, config, logs) se guardan en `~/.hive` del host gracias al volumen montado. Actualizar a una nueva versión no borra tu configuración:
+**Actualizar a la última versión:**
+
+```bash
+docker compose pull        # descarga la imagen más reciente de Docker Hub
+docker compose up -d       # reinicia el contenedor con la nueva imagen
+```
+
+Los datos (BD, config, logs) se persisten en el volumen `hive-data` — actualizar no borra tu configuración.
+
+**Ver logs en tiempo real:**
 
 ```bash
-docker pull johpaz/hive:latest
-docker compose up -d   # reinicia con la nueva imagen
+docker compose logs -f hive
 ```
 
 ---
 
 ### Opción 2 — Binario standalone (Sin dependencias)
 
-Descarga un ejecutable único para tu plataforma. No requiere Node, Bun ni Docker.
+Descarga un ejecutable único para tu plataforma. No requiere Node, Bun ni Docker. Al ejecutarlo, **el navegador se abre automáticamente** en `/setup` (primera vez) o en el dashboard.
 
 | Plataforma | Descarga |
 |------------|----------|
-| Linux x64 | [hive-v1.7.2-linux-x64](https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.2-linux-x64) |
-| Linux ARM64 | [hive-v1.7.2-linux-arm64](https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.2-linux-arm64) |
-| macOS Intel | [hive-v1.7.2-macos-x64](https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.2-macos-x64) |
-| macOS Apple Silicon | [hive-v1.7.2-macos-arm64](https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.2-macos-arm64) |
-| Windows x64 | [hive-v1.7.2-windows-x64.exe](https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.2-windows-x64.exe) |
+| Linux x64 | [hive-v1.7.7-linux-x64](https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.7-linux-x64) |
+| Linux ARM64 | [hive-v1.7.7-linux-arm64](https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.7-linux-arm64) |
+| macOS Intel | [hive-v1.7.7-macos-x64](https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.7-macos-x64) |
+| macOS Apple Silicon | [hive-v1.7.7-macos-arm64](https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.7-macos-arm64) |
+| Windows x64 | [hive-v1.7.7-windows-x64.exe](https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.7-windows-x64.exe) |
 
 **Instalación en Linux / macOS:**
 
 ```bash
-# Descargar (ajusta la URL a tu plataforma)
-curl -L -o hive https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.2-linux-x64
+# 1. Descargar binario (ajusta la URL a tu plataforma)
+curl -L -o hive https://github.com/johpaz/hive/releases/latest/download/hive-v1.7.7-linux-x64
 chmod +x hive
 
-# Descargar la UI
+# 2. Descargar la UI
 curl -L https://github.com/johpaz/hive/releases/latest/download/ui-dist.tar.gz | tar -xz
 mkdir -p ~/.hive/ui && mv ui-dist/* ~/.hive/ui/
 
-# Ejecutar — abre el browser en /setup automáticamente
+# 3. Ejecutar — el navegador se abre automáticamente
 ./hive start
 ```
 
 **Instalación en Windows:**
 
 ```powershell
-# Descargar el binario desde el link de arriba y ejecutar
-.\hive-v1.7.2-windows-x64.exe start
+# 1. Descargar hive-v1.7.7-windows-x64.exe desde el link de arriba
+# 2. Descargar ui-dist.tar.gz y extraer en %USERPROFILE%\.hive\ui\
+# 3. Ejecutar
+.\hive-v1.7.7-windows-x64.exe start
+```
+
+**¿Dónde se guardan los datos?**
+
+Todos los datos (base de datos, configuración, logs) se guardan en `~/.hive/` por defecto:
+
+```
+~/.hive/
+├── data/
+│   └── hive.db        ← base de datos SQLite (agentes, conversaciones, config)
+├── ui/                ← archivos de la interfaz web
+├── logs/
+│   └── gateway.log
+└── gateway.pid
 ```
 
-La UI se sirve desde `~/.hive/ui/`. También puedes apuntar a una ruta custom con `HIVE_UI_DIR=/ruta/a/ui`.
+La UI se sirve desde `~/.hive/ui/`. Puedes apuntar a una ruta alternativa con la variable `HIVE_UI_DIR`.
 
-**Caso de uso portable (USB):**
+**Variables de entorno:**
 
-Copia el binario y la carpeta `~/.hive` a una USB. En cualquier equipo compatible:
+| Variable | Default | Descripción |
+|----------|---------|-------------|
+| `HIVE_HOME` | `~/.hive` | Directorio raíz de datos |
+| `HIVE_PORT` | `18790` | Puerto del gateway |
+| `HIVE_HOST` | `127.0.0.1` | Interfaz de red |
+| `HIVE_UI_DIR` | `~/.hive/ui` | Ruta alternativa para la UI |
+
+---
+
+### Uso portable — USB o disco externo
+
+El binario standalone es ideal para llevarlo en una USB. Tu agente viaja contigo con toda su memoria, historial y configuración.
+
+**Estructura recomendada en la USB:**
+
+```
+/usb/
+├── hive                  ← binario ejecutable
+├── ui/                   ← archivos de la interfaz web (copiar de ui-dist/)
+└── datos/                ← directorio de datos (se crea automáticamente)
+    ├── data/hive.db
+    └── ...
+```
+
+**Preparar la USB (desde tu máquina):**
 
 ```bash
-HIVE_HOME=/media/usb/hive-data ./hive start
+# Copiar binario
+cp hive-v1.7.7-linux-x64 /media/usb/hive
+chmod +x /media/usb/hive
+
+# Copiar UI
+cp -r ui-dist/* /media/usb/ui/
+
+# (Opcional) Copiar datos existentes
+cp -r ~/.hive/data /media/usb/datos/
 ```
 
-Tu agente viaja contigo, con toda su memoria y configuración.
+**Ejecutar en cualquier equipo Linux:**
 
----
+```bash
+HIVE_HOME=/media/usb/datos HIVE_UI_DIR=/media/usb/ui /media/usb/hive start
+```
+
+El navegador se abre automáticamente. Si es la primera vez en ese equipo, muestra el wizard de setup. Si ya tienes datos en la USB, carga tu agente directamente.
 
-### Opción 3 — npm / bun (Para desarrolladores)
+**En macOS:**
 
 ```bash
-# Con npm
-npm install -g @johpaz/hive
+HIVE_HOME=/Volumes/USB/datos HIVE_UI_DIR=/Volumes/USB/ui /Volumes/USB/hive start
+```
+
+**Backup de datos:**
+
+```bash
+# Hacer backup de la BD
+cp ~/.hive/data/hive.db ~/backup-hive-$(date +%Y%m%d).db
+
+# Restaurar
+cp ~/backup-hive-20260310.db ~/.hive/data/hive.db
+```
 
-# Con bun
+---
+
+### Opción 3 — bun (Para desarrolladores)
+
+> Requiere Bun instalado — ver prerequisito al inicio de esta sección.
+
+**Instalación global:**
+
+```bash
 bun install -g @johpaz/hive
+```
+
+> Si instalas con `npm install -g @johpaz/hive` también funciona, pero igualmente necesitas Bun instalado — el CLI lo usa como runtime.
+
+**Iniciar:**
 
-# Iniciar
+```bash
 hive start
 ```
 
-Si es la primera vez, el setup web se abre automáticamente en `http://localhost:18790/setup`.
+El navegador se abre automáticamente en `http://localhost:18790`. Si es la primera vez, redirige a `/setup` para configurar tu agente.
 
-Para configurar desde la terminal en lugar del browser:
+**Configurar desde terminal** (sin browser):
 
 ```bash
 hive onboard
 ```
 
+**Comandos útiles:**
+
+```bash
+hive status          # estado del gateway
+hive logs --follow   # logs en tiempo real
+hive stop            # detener el gateway
+hive doctor          # diagnóstico del sistema
+```
+
+**Actualizar a la última versión:**
+
+```bash
+bun install -g @johpaz/hive   # instala la versión más reciente
+hive stop && hive start        # reinicia el gateway
+```
+
+**Modo desarrollo** (hot-reload + Vite, para contribuir al proyecto):
+
+```bash
+git clone https://github.com/johpaz/hive.git && cd hive
+bun install
+bun run dev
+```
+
 ---
 
 ## Los Cuatro Pilares
@@ -331,8 +501,9 @@ Hive llama directamente a los SDKs oficiales de cada provider:
 | Anthropic | `@anthropic-ai/sdk` | claude-sonnet-4-6, claude-opus-4-6 |
 | OpenAI | `openai` | gpt-4o, gpt-4.1 |
 | Groq | `openai` (compat) | llama-3.3-70b, mixtral-8x7b |
-| Mistral | `openai` (compat) | mistral-large |
-| DeepSeek | `openai` (compat) | deepseek-chat |
+| Mistral AI | `openai` (compat) | mistral-large, codestral |
+| DeepSeek | `openai` (compat) | deepseek-chat, deepseek-reasoner |
+| Kimi (Moonshot) | `openai` (compat) | moonshot-v1-8k, moonshot-v1-128k |
 | Ollama | `openai` (compat) | llama3, qwen2.5, etc. |
 | OpenRouter | `openai` (compat) | cualquier modelo de la plataforma |