py-agent
Py-Agent es un orquestador local-first en Python que impulsa un backend C++ llama-server de alto rendimiento. Utiliza directivas optimizadas y adaptadores para automatización, IA y desarrollo. Soporta modelos locales (gguf) y remotos (HuggingFace, OpenRouter), con interfaces CLI, TUI y Web.
Ficha actualizada 24 sept 2026, 18:44 · upstream 24 sept 2026, 18:26 · release sin release detectada
Qué es py-agent
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Py-Agent es una herramienta de orquestación local-first escrita en Python que impulsa un backend C++ llama-server de alto rendimiento. Está diseñado para automatización, inteligencia artificial y desarrollo, ofreciendo una arquitectura optimizada con directivas, flags y adaptadores. Soporta tanto modelos locales (formato gguf) como remotos a través de HuggingFace, OpenRouter o Gemini, permitiendo una flexibilidad operativa significativa sin depender exclusivamente de la nube.
- Automatización de tareas locales utilizando modelos SLM compactos como Ling-3.0-tiny para velocidad extrema.
- Refactorizado de código multi-fichero y razonamiento profundo con LLMs grandes como Qwen3.8-35B-Distill.
- Chat interactivo y edición de código en tiempo real mediante la interfaz CLI o PyCode IDE.
- Búsqueda web y grounding con APIs externas (Gemini, OpenRouter) para tareas que requieren contexto externo.
- Interfaz Web autónoma para usuarios no expertos en terminal mediante el proxy llama-server.
- Integración en flujos de trabajo de desarrollo local mediante la extensión PyCode IDE.
- Backend C++ llama-server que permite ejecución sub-milisegundo y alto throughput.
- Adaptadores auto-curativos (/adp) que reparan JSON malformado o parámetros sin overhead cuando las llamadas son nativas.
- Seguridad hardened con puertas de confirmación no eludibles para comandos del sistema como sudo o pacman.
- Gestión de memoria global editable (.md) que permite instrucciones del sistema y directivas de workspace.
- Eficiencia tokenómica superior comparada con soluciones Node.js, reduciendo significativamente el consumo en modo idle.
- Soporte nativo para múltiples modelos (SLM y LLMs) sin necesidad de cambiar la infraestructura subyacente.
- No incluye Dockerfile ni Compose; requiere instalación manual de dependencias como python-rich y python-requests.
- Estado actual en Beta, indicado por el badge oficial en el README del repositorio.
- Dependencia de llama.cpp para modelos locales, lo que implica requisitos de hardware específicos (RAM/CPU) no gestionados por contenedores.
- Configuración inicial manual vía archivo .env o TUI, sin un script de instalación 'one-click' simplificado.
- Licencia MODIFIED MIT; verificar compatibilidad con políticas corporativas estrictas antes del despliegue.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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 dependencias (pacman o pip), clonar repositorio en ~/.config/py-agent y activar hook en .bashrc. Configurar proveedores vía .env o usar 'model select' interactivo. Asegurar espacio en disco y RAM según modelo seleccionado. No requiere contenedores, ejecuta directamente en el sistema local.
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.