claude-homelab
Hub de plugins para Claude Code/Codex/Gemini enfocado en gestión de homelab. Integra automatización de medios, monitorización de infraestructura, gestión documental y herramientas de investigación mediante comandos especializados y agentes.
Ficha actualizada 18 sept 2026, 18:59 · upstream 5 ago 2026, 5:12 · release v1.4.1
Qué es claude-homelab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
claude-homelab es un repositorio mono-repo que actúa como fuente de verdad para el plugin `homelab-core` publicado en el marketplace de Claude. Sirve como integración centralizada para 16 servicios de homelab, incluyendo Plex, Radarr, Sonarr, Unraid, UniFi y Paperless-ngx, proporcionando una superficie de trabajo unificada para agentes, comandos y habilidades (skills).
El repositorio soporta tres roles simultáneos: plugin del marketplace, repositorio canónico para integraciones de skills y fuente de manifiestos para extensiones de Codex y Gemini. Incluye scripts de instalación que gestionan prerequisites (`git`, `jq`, `curl`), clonación del repo, configuración de credenciales en `.env` con permisos seguros (600) y creación de symlinks hacia `~/.claude/`. La arquitectura es LOW complexity, ejecutándose en entornos de 1 núcleo CPU y 1 GB RAM.
La gestión de credenciales centralizada ocurre en `~/.claude-homelab/.env`, cargado vía `scripts/load-env.sh` con validación estricta. El sistema incluye comandos raíz (`/check`, `/deploy`, `/quick-push`) y comandos especializados (`/homelab:*` para recursos, Docker, disco, ZFS) y una suite completa de NotebookLM para creación de notebooks, chat, generación de artefactos (audio, video, infografías) e investigación web.
- Automatización de medios: gestión de descargas con Radarr/Sonarr, sincronización con Plex/Overseerr y notificaciones vía Gotify.
- Monitorización de infraestructura: auditoría de Docker, análisis de ZFS, revisión de recursos del sistema (CPU/RAM) y detección de anomalías en Unraid/Tailscale.
- Gestión documental centralizada: integración con Paperless-ngx, Linkding, Memos y Radicale para gestión de documentos y calendarios.
- Investigación y análisis con NotebookLM: creación de notebooks desde URLs/PDFs, generación de artefactos (podcasts, infografías) e investigación web profunda.
- Integración unificada para 16 servicios de homelab en un solo plugin.
- Modelo de credenciales seguro con `.env` gestionado, validado y nunca commitado.
- Comandos especializados para NotebookLM que soportan generación de artefactos multimedia e investigación web.
- Herramientas de auditoría de infraestructura (Docker, ZFS, recursos) con recomendaciones automáticas.
- Scripts de instalación automatizados que verifican prerequisites y symlinks.
- Dependencia manual de configuración de credenciales en `.env` sin autenticación automática.
- Falta de soporte nativo para Docker (usa scripts externos para despliegue de plugins MCP).
- Requiere permisos de administrador del sistema para crear symlinks y modificar `~/.claude/`.
- Algunas funcionalidades avanzadas (ej. generación de video) requieren tiempos de espera significativos.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar vía marketplace o script oficial (`scripts/install.sh`). Configurar `.env` manualmente con credenciales y permisos `chmod 600`. Verificar symlinks con `verify.sh` antes de operar. Para despliegue de plugins MCP externos, usar `/deploy <plugin-name>`. Evitar editar archivos en `~/.claude/plugins/cache/` directamente.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.