Content
<div align="center">
# JARVIS OS
### Un ecosistema de orquestación multi-agente sobre CLIs de IA
*Skills, memoria estratificada, MCPs, hooks de seguridad, voz, y delegación
paralela — coordinando Claude Code, Antigravity, Codex y OpenCode como un solo equipo.*
*Dashboard v5 en producción: statusline del enjambre (estilo tmux), 9/9 servidores MCP,
telemetría de contexto y matriz de servicios — **todo dato mostrado es real y verificable**.*
</div>
---
> **Nota:** Este repositorio es un **showcase técnico sanitizado** de un sistema personal en
> producción. No contiene secretos, credenciales ni datos privados (ver [SECURITY.md](SECURITY.md)).
> Su propósito es documentar la arquitectura, las decisiones de diseño y las capacidades
> del ecosistema como evidencia de trabajo con herramientas modernas de IA.
## ¿Qué es JARVIS OS?
JARVIS OS es un **harness de orquestación nativo de Linux** que trata a varios CLIs de modelos
de lenguaje (Claude Code, Antigravity/Gemini, Codex, OpenCode) como un **enjambre de especialistas**
que colaboran vía `tmux`, un proxy multi-proveedor, y memoria compartida en disco.
La idea central: **ningún modelo único debe cargar todo el trabajo**. Un orquestador primario
(Claude, Opus) toma decisiones de arquitectura y delega lo mecánico a workers más económicos,
con relevo automático cuando un proveedor agota su cuota — protegiendo contexto, costo y continuidad.
## Capacidades clave
| Subsistema | Qué hace |
|---|---|
| 🧠 **Orquestación** | Detección del CLI activo, ranking por rango, delegación a workers, relevo por cuota con *briefing* de contexto |
| 🎙️ **Voz** | Wake word always-on (openWakeWord) + push-to-talk, STT (Whisper), TTS multi-voz (JARVIS/Catalina), grabación VAD |
| 🔌 **MCP servers** | Control de escritorio, captura de pantalla, OBS, Android (ADB), memoria SQLite, zona horaria — vía Model Context Protocol |
| 🔀 **Proxy / Routing** | LiteLLM con cascada de fallback multi-proveedor (DeepSeek → Qwen → GLM → Gemini → Groq → red local) |
| 💾 **Memoria + RAG** | Capa léxica SQLite FTS5 + capa semántica FAISS sobre la documentación del ecosistema |
| 🧩 **Skills** | Patrones procedimentales reusables en markdown, distribuidos a cada CLI por symlink |
| 🖥️ **UI / Remoto** | Tray de estado, overlay de chat flotante, control remoto seguro vía Tailscale con permisos por dispositivo |
| 📊 **Dashboard v5** | Next.js 15 + Tailwind v4: statusline del enjambre en vivo, salud MCP, telemetría de tokens, cola de tickets, consola de chat SSE — cero métricas simuladas |
| 🛡️ **Gobernanza** | Hook PreToolUse de bloqueo (`governance_safety`), anti prompt-injection (`prompt_security`), allowlist+DLP en el gateway, ban de gestores inseguros (npm→pnpm), aprobación humana para acciones de riesgo |
## Arquitectura (vista general)
```
┌──────────────────────────────┐
│ ORQUESTADOR PRIMARIO │
│ Claude Code (decisiones) │
└───────────────┬────────────────┘
delega │ relevo por cuota
┌────────────────────┬───────────┼───────────┬────────────────────┐
▼ ▼ ▼ ▼ ▼
Antigravity Codex OpenCode Sub-agentes Catalina
(refactor/long) (debug) (worker) (Gemini/proxy) (operativa)
└────────────────────┴───────────┬───────────┴────────────────────┘
│ costuras de interconexión
┌─────────────────────────────────┼─────────────────────────────────┐
│ MCP (stdio) · SQLite memoria · JSONL bus · tmux │
└─────────────────────────────────┬─────────────────────────────────┘
▼
Memoria compartida · Proxy LiteLLM · Voz · UI
```
Ver [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) para el diseño completo, incluida la
**federación políglota (Camino C)** con el harness [ECC](integrations/ecc/).
## Estructura del repositorio
```
jarvis-os/
├── src/ Código de funcionamiento, organizado por subsistema
│ ├── orchestration/ Detección de CLIs, sesiones, swarm, delegación
│ ├── voice/ Daemon de voz, STT/TTS, wake word, briefing
│ ├── mcp-servers/ Servidores MCP (desktop, screen, obs, adb, memory, timezone)
│ ├── proxy/ Router LiteLLM multi-proveedor
│ ├── memory-rag/ Memoria SQLite + RAG semántico FAISS
│ ├── governance/ Hooks de seguridad + anti prompt-injection
│ ├── dashboard/ Dashboard v5 (Next.js 15, datos 100% reales)
│ └── ui-remote/ Tray, overlay, control remoto Tailscale
├── assets/ Capturas del sistema en producción
├── skills/ Patrones procedimentales reusables (markdown)
├── agents/ Especificaciones de sub-agentes
├── config/ Plantillas de configuración (*.example, sin secretos)
├── integrations/ecc/ Federación con el harness ECC (atribuida)
├── docs/ Documentación en cascada (subsistemas → artefactos)
└── scripts/ Utilidades de mantenimiento del propio repo
```
## Documentación
- **[docs/WHAT_IS_JARVIS.md](docs/WHAT_IS_JARVIS.md)** ([ES](docs/QUE_ES_JARVIS.md)) — la tesis: un *sistema operativo de agentes*, con tabla de madurez honesta.
- **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** — diseño del sistema, costuras, decisiones.
- **[docs/STATUS.md](docs/STATUS.md)** — estado verificado del sistema + runbook de arranque.
- **[docs/MODELS.md](docs/MODELS.md)** — fuente única de asignación de modelos por tarea.
- **[docs/subsystems/](docs/subsystems/)** — un documento por subsistema.
- **[docs/tools/](docs/tools/), [docs/mcps/](docs/mcps/), [docs/skills/](docs/skills/)** — referencia por artefacto.
- **[SECURITY.md](SECURITY.md)** — política de sanitización.
## Stack
`Python` · `LiteLLM` · `Model Context Protocol (MCP)` · `Whisper` · `openWakeWord` · `edge-tts/Kokoro`
· `FAISS` · `SQLite FTS5` · `tmux` · `Tailscale` · `pnpm` · `Next.js 15` · `React 19` · `Tailwind v4`
## Estado
Sistema personal en producción y evolución continua — todo corre 24/7 en hardware modesto
(RTX 2060 6 GB / 11 GB RAM). Último ciclo de hardening: **2026-07** (9/9 MCPs verificados,
fuente única de modelos, dashboard v5 sin métricas simuladas). Próximas: federación completa
con ECC (memoria compartida ya probada end-to-end), integración n8n. La arquitectura está
diseñada para crecer de forma modular — cada nueva herramienta es un módulo + su documentación.
## Licencia
MIT — ver [LICENSE](LICENSE). El harness ECC integrado mantiene su propia licencia MIT y autoría.
