AI HQ
Un centro de mando personal para trabajar con IA. Muestra en directo las sesiones de Claude Code, el gasto y una GPU local a la que Claude puede delegar tareas.
- Rol
- Proyecto personal · diseño y desarrollo
- Cuándo
- 2026
- Repo
- Repositorio privado
- local: todos los servicios escuchan en 127.0.0.1
- 100%
- herramientas MCP disponibles para Claude Code
- 10+
- plataformas: WSL2, macOS y Linux
- 3
El problema
Trabajo a diario con varias sesiones de Claude Code, cada una con sus subagentes, y tengo una RTX 4090 al lado. No tenía un sitio único donde ver qué hacían los agentes ni cuánto costaban, ni forma de que delegaran el trabajo sencillo en la GPU en lugar de consumir el plan.
Qué construí
AI HQ es un único panel, pensado para un monitor ultrapanorámico, que muestra toda la actividad de IA de una máquina:
- Sesiones y agentes en directo. Un servidor FastAPI lee los logs JSONL de Claude Code, los guarda en SQLite y emite los cambios por WebSocket. La interfaz muestra sesiones, subagentes y tool calls en el momento en que ocurren.
- La constelación. Un grafo en canvas en el que las sesiones son nodos centrales, los subagentes orbitan a su alrededor y los archivos se iluminan al tocarse. Se puede reproducir cualquier día hasta a 300×.
- Gasto y uso del plan. Gasto a precios de lista de la API e indicadores de la ventana del plan que proyectan si el ritmo actual se queda dentro del límite.
- Un gateway local para la GPU. Telemetría NVML, una cola de trabajos con planificador de memoria y un router compatible con OpenAI delante de Ollama, ComfyUI y los motores de voz.
Modo híbrido
Un servidor MCP da a cada proyecto de Claude Code herramientas como local_llm, transcribe, speak y generate_image. Claude delega en el modelo local los borradores, extracciones o tareas multimedia sencillas, y el panel muestra quién envió qué y cuánto habría costado en la nube. Parte de los textos en español de este portfolio se redactaron así y después se revisaron.
Decisiones de ingeniería
- Solo local, por diseño. Los servicios rechazan hosts no locales, las claves se quedan en
.envy los prompts nunca llegan al panel. - Funciona en todas las plataformas. Docker Compose con NVIDIA en WSL2 y Linux, y un entorno virtual nativo con LM Studio en Apple Silicon. Si una plataforma no tiene una función, esta se desactiva limpiamente.
- Verificado como un producto. Suites de pytest en contenedores, typecheck, vitest y capturas de Playwright en ultrapanorámico, escritorio y móvil.