EulerAgent

Framework de Agentes CLI Local-First

Un framework de agentes seguro basado en la aprobación Human-in-the-Loop (HITL). Cada acción se registra, audita y aprueba. Mantiene el contexto entre sesiones mediante memoria a largo plazo y RAG.

Open Source

Funcionalidades Principales

Seguridad, Memoria, Orquestación -- los tres pilares de EulerAgent

Seguridad Human-in-the-Loop

  • Modelo de Seguridad Deny-All: Todas las herramientas bloqueadas por defecto; se requiere permiso explícito
  • Aprobación Humana Obligatoria: Las acciones de alto riesgo (escritura de archivos, ejecución de shell, llamadas externas) requieren aprobación humana
  • Máquina de Estados de 8 Fases: CREATE → CONTEXT → PLAN → PROPOSE → APPROVE → EXECUTE → RESULT → FINALIZE
  • Pista de Auditoría Completa: Cada acción registrada mediante Audit Trail

Memoria a Largo Plazo & RAG

  • Basado en SQLite: Historial de conversaciones y búsqueda vectorial
  • Extracción Automática de Contexto: Aprendizaje automático de preferencias del usuario y contexto del proyecto
  • RAG Híbrido: Base de conocimientos local + búsqueda web
  • Proveedores de Búsqueda MCP: Integración con Brave, Tavily y más

Orquestación de Flujos de Trabajo

  • Pattern Orchestrator: Flujos de trabajo basados en YAML (12 patrones canónicos)
  • Graph Orchestrator: Ejecución paralela basada en LangGraph (experimental)
  • Descomposición Dinámica de Tareas: --dynamic opción
  • Nodos de Juicio y Bucles de Calidad: Evaluación automática de la calidad de salida e iteración

Plantillas de Agentes

Cree agentes rápidamente con plantillas diseñadas para cada propósito

Plantilla Propósito
personal-assistant Asistente personal de uso general
marketing-expert Creación de contenido de marketing
code-assistant Escritura de código y depuración
ops-assistant Gestión de operaciones e infraestructura

Inicio Rápido CLI

Cree y ejecute un agente con un solo comando

# Inicializar espacio de trabajo
euleragent init

# Crear un agente
euleragent new my-assistant --template personal-assistant

# Ejecutar en modo Plan (proponer y luego aprobar)
euleragent run my-assistant --task "Escribir resumen del proyecto" --mode plan

# Ejecutar en modo Execute (ejecución automática de bajo riesgo)
euleragent run my-assistant --task "Refactorizar código" --mode execute

# Gestión de aprobaciones
euleragent approve list
euleragent approve accept <id> --actor "user:name" --execute

# Chat interactivo (memoria a largo plazo activada)
euleragent chat my-assistant --project default --continue

Referencia CLI

Sistema completo de comandos de EulerAgent

Comandos Principales

Comando Descripción
euleragent init Inicializar espacio de trabajo
euleragent new Crear agente desde plantilla
euleragent run Ejecutar agente (modo plan/execute)
euleragent chat Sesión de chat interactivo
euleragent logs Ver registros de auditoría de ejecución
euleragent doctor Verificación del estado del sistema

Gestión de Aprobaciones

Comando Descripción
euleragent approve list Lista de aprobaciones pendientes
euleragent approve show <id> Detalles de aprobación
euleragent approve accept <id> Aceptar y ejecutar aprobación
euleragent approve reject <id> Rechazar aprobación
euleragent approve accept-all Aprobación por lotes

Base de Conocimientos (RAG)

Comando Descripción
euleragent rag init Inicializar base de conocimientos
euleragent rag add --path ./docs/ Agregar documentos
euleragent rag query --q "término de búsqueda" Buscar en la base de conocimientos
euleragent rag status Verificar estado de KB

Gestión de Memoria

Comando Descripción
euleragent memory status Estadísticas del almacén de memoria
euleragent memory search --q "término de búsqueda" Buscar conversaciones pasadas

Flujos de Trabajo & Patrones

Comando Descripción
euleragent workflow show <run-id> Estructura y estado del flujo de trabajo
euleragent workflow resume <run-id> Reanudar flujo de trabajo
euleragent pattern list Listar patrones disponibles
euleragent pattern run <pattern> <agent> Ejecutar flujo de trabajo basado en patrón

Gestión MCP

Comando Descripción
euleragent mcp sync Sincronizar catálogo del servidor MCP
euleragent mcp show Estado actual de MCP

Tutoriales

Domine EulerAgent con guías paso a paso

Tutoriales en coreano | English Tutorials

Tutoriales próximamente.

Instalación y Primeros Pasos

Instale EulerAgent y ejecute su primer agente

Instalación

pip install euleragent

# Descargar modelo de Ollama
ollama pull qwen3:32b

# Inicializar espacio de trabajo
euleragent init

Requisitos

  • Python 3.11+
  • Ollama (o clave API de OpenAI/Gemini)

Ejemplo de Configuración

Configure el entorno del agente de forma declarativa con workspace.yaml

workspace.yaml

llm_profiles: local: provider: ollama model: qwen3:32b openai: provider: openai model: gpt-4o-mini is_external: true default_llm_profile: local memory: enabled: true mcp: enabled: true

Comience a construir agentes de IA seguros con EulerAgent

Código abierto, basado en aprobación humana, ejecución local-first.

Comenzar en GitHub Contáctenos