Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

openalpheus

Herramienta self-hosted de marco multi-agente para operadores y equipos pequeños.

Ficha actualizada 22 sept 2026, 20:22 · upstream 22 sept 2026, 20:06 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es openalpheus

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

OpenAlpheus es un marco multi-agente autocontenido que permite a los operadores individuales o equipos pequeños ejecutar agentes de IA como procesos Unix aislados en su hardware. Se basa en Matrix como capa de transporte, con archivos JSONL locales que guardan el estado de las sesiones y systemd para la gestión del ciclo de vida. Solo requiere cinco dependencias Python directas: anthropic, openai, matrix-nio, mistune y httpx. No se necesita nube a menos que el usuario lo configure explícitamente.

El proyecto está en versión 0.1.2 (primera versión). El núcleo está estable y ha pasado más de 2.650 pruebas unitarias. La interfaz puede evolucionar con el tiempo.

El diseño se centra en la transparencia, la controlabilidad y la simplicidad operativa.

CASOS DE USO
  • Gestión de equipos distribuidos a través de salas de Matrix
  • Automatización de tareas repetitivas mediante agentes especializados
  • Monitoreo de seguridad con agentes que ejecutan comandos en Unix
  • Coordinación entre múltiples agentes para proyectos complejos
  • Manejo de documentos y archivos mediante herramientas de lectura/edición
  • Búsqueda contextualizada de información con memoria persistente
PUNTOS DESTACADOS
  • Cada agente corre como un proceso Unix aislado, garantizando que una falla no afecte a los demás
  • Total control sobre el prompt: cada agente recibe su propio archivo markdown editable y editable
  • Compatible con herramientas Linux estándar (systemctl, journalctl, grep, nano)
  • Transparencia total de acciones: todos los pasos del agente se registran en la historia de chat
  • Mantenibilidad con ~17.000 líneas de código y cobertura de línea del 85% (2.650+ pruebas)
  • Soporte para visión por modelo a nivel de capa, no de agente individual
PRECAUCIONES
  • Requiere configuración manual: no ofrece un despliegue "one-click" sin intervención
  • Los agentes son aislados entre sí; no pueden compartir estado o conocimiento entre sesiones
  • La visión por modelo es una capa de capa superior, no una funcionalidad del agente en sí mismo
  • El contexto tiene límites: el GC reduce el historial para mejorar rendimiento, lo que puede perder información relevante
  • Requiere un servidor Matrix (Tuwunel) y un dominio propio o certificado TLS configurado
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA8 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADlownivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Instalación con curl: curl -fsSL https://github.com/merryshelly/openalpheus/raw/refs/heads/main/install.sh | sudo bash Opción no interactiva: sudo OPENALPH_AGENT_NAME=myagent \ OPENALPH_PROVIDER=anthropic \ OPENALPH_API_KEY_FILE=/path/to/key \ OPENALPH_DOMAIN=myhost.tailnet.ts.net \ OPENALPH_TLS_MODE=tailscale \ bash install.sh Requisitos de infraestructura: - Linux con systemd (para el agente) y tuwunel (Matrix homeserver) - Dominio propio o servidor VPS con TLS configurado (Caddy, Let's Encrypt) - Acceso a API de Anthropic para modelos como Claude 3.5 - Memoria RAM suficiente: mínimo 8GB, recomendado 16GB+ - Disco local de al menos 10 GB para el workspace del agente - Python 3.9+ instalado en el servidor - Caddy o un proxy TLS configurado para la comunicación con Matrix

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.jsPython
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
No detectados
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.