hugpy-agent
Runtime de agentes portables para flota LLM auto-alojada hugpy. Escrito en Python 3.10+ con stdlib, sin dependencias externas. Soporta modo daemon systemd, CLI interactiva y nodos de flota distribuidos con journal SQLite crash-safe y herramientas locales aisladas.
Ficha actualizada 24 sept 2026, 17:40 · upstream 24 sept 2026, 17:29 · release sin release detectada
Qué es hugpy-agent
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
hugpy-agent es un runtime de agentes diseñado para operar como cliente HTTP dentro de la flota auto-alojada de hugpy. Funciona principalmente como un daemon en segundo plano gestionado por systemd (modo serve) o mediante una consola interactiva (console). El sistema utiliza un journal basado en SQLite para garantizar la seguridad ante fallos, permitiendo reanudar tareas interrumpidas y mantener auditoría completa de cada ejecución.
La arquitectura separa las herramientas locales, que operan dentro del workspace con permisos restringidos (jailed), de las llamadas a la flota de modelos. Soporta tanto el procesamiento local como servicios remotos para ML (texto, visión) y generación de imágenes asíncronas. El agente puede funcionar como nodo independiente en una flota más amplia, registrándose con un central para recibir tareas dispatchadas automáticamente.
La configuración se gestiona mediante variables de entorno, archivos .env o agent.toml, priorizando claves seguras fuera del control de versiones. Incluye una consola TUI nativa en Python usando curses para monitorear modelos, trabajadores y colas sin necesidad de Node.js ni navegador, aunque la interfaz interactiva OpenCode requiere Node 18 como paridad opcional.
- Automatización de tareas mediante prompts en Discord o cola local
- Análisis y documentación de repositorios de código con herramientas locales
- Generación de imágenes y escenas visuales asíncronas vía flota
- Monitoreo de estado de flota LLM desde terminal sin navegador
- Ejecución segura de scripts shell dentro del workspace aislado
- Cero dependencias externas: utiliza únicamente Python stdlib para el agente principal
- Journal SQLite crash-safe permite reanudar tareas interrumpidas automáticamente
- Sandboxing de herramientas locales (jailed) previene acceso fuera del workspace
- Arquitectura nodo-central soporta despliegue distribuido en flotas heterogéneas
- Consola TUI nativa en Python con curses para monitoreo sin Node.js ni navegador
- No incluye Dockerfile o docker-compose, requiere instalación manual de entorno Python
- Requiere Python 3.10 mínimo; sistemas antiguos como macOS 10.8 no son compatibles
- La consola interactiva OpenCode necesita Node.js 18 instalado aparte (opcional)
- Modo nodo depende de un central activo; si el central revoca el token, el nodo entra en idle
- Las herramientas shell están clasificadas como destructivas y requieren precaución
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 con bootstrap.sh para systemd user service o manualmente con python -m venv. Configurar HUGPY_API_KEY y HUGPY_BASE en entorno. Para modo nodo, usar serve --node y registrar con central. La consola se ejecuta con hugpy-agent console. Asegurar permisos 0600 en archivos de configuración y state.
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.