Skip to content

v4mpir0ck/agent-linux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

131 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 Proyecto Agente IA Linux

Índice

Este proyecto tiene tres líneas principales de trabajo:


graph TD
	 A[Agente IA para Linux] --> B[CLI interactivo]
	 A --> C[Opciones avanzadas]
	 A --> D[Integración LLM]
	 E[Pipelines CI/CD] --> F[Build multiplataforma]
	 E --> G[Release automatizado]
	 E --> H[Dockerfiles por distro]
	 I[Generador de Dataset] --> J[Extracción Q&A]
	 I --> K[Conversión a formatos Azure]
	 I --> L[Automatización con LLM]
	 subgraph Proyecto
		  A
		  E
		  I
	 end
Loading

Workstreams

  1. Agente IA para Linux

    • CLI interactivo y seguro
    • Ejecución de comandos y diagnósticos
    • Integración con LLM (Azure OpenAI)
    • Configuración persistente y portable
  2. Pipelines CI/CD

    • Workflows para compilar binarios por distro
    • Publicación automática en GitHub Releases
    • Dockerfiles y scripts para builds reproducibles
  3. Generador de Dataset personalizado

    • Extracción automática de Q&A desde repositorios
    • Conversión a formatos compatibles con Azure OpenAI (Direct Preference)
    • Automatización y limpieza de datos

Documentación y enlaces


Instalación rápida (binario portable)

Tienes dos opciones para instalar y usar el agente:

  1. Descargar y ejecutar el binario directamente

    • El agente incluye binarios portables de herramientas de red (nmap, netstat, lsof, ss, tcpdump) para cada distribución soportada. El binario detecta tu sistema y usa los binarios auxiliares incluidos si están disponibles.
    • Si no se encuentran binarios para tu distro, se usarán los del sistema o deberás instalarlos manualmente.

    Descarga el binario desde GitHub Releases según tu distribución:

    Fedora / RHEL / UBI

    curl -L -o agent "https://github.com/v4mpir0ck/agent-linux/releases/download/v1.0.14-Dockerfile.ubi8/agent"
    chmod +x agent
    ./agent

    Ubuntu

    curl -L -o agent "https://github.com/v4mpir0ck/agent-linux/releases/latest/download/agent-Dockerfile.ubuntu"
    chmod +x agent
    ./agent
  2. Instalar mediante script

    • Puedes usar el script instalar_agente.sh para instalar el agente y copiar automáticamente los binarios auxiliares de red en el sistema.
    • Esto es útil si quieres una instalación más integrada o necesitas que los binarios estén disponibles globalmente.

    Puedes descargar el script con curl y ejecutarlo directamente:

    curl -L -o instalar_agente.sh "https://raw.githubusercontent.com/v4mpir0ck/agent-linux/main/instalar_agente.sh"
    bash instalar_agente.sh

Requisitos de configuración para el agente IA

Para que el agente funcione correctamente, es necesario:

  1. Tener un modelo de Azure OpenAI desplegado en tu suscripción (por ejemplo, GPT-4, GPT-3.5, etc).
  2. Proporcionar los valores de configuración al agente al arrancar:
    • AZURE_OPENAI_ENDPOINT: URL del endpoint de tu modelo desplegado.
    • AZURE_OPENAI_KEY: Clave de acceso a la API.
    • AZURE_OPENAI_DEPLOYMENT: Nombre del deployment/modelo configurado.

Puedes pasar estos valores como variables de entorno, en un archivo .env, o directamente en la configuración del agente.

Sin estos datos, el agente no podrá conectarse al modelo y no funcionará correctamente.

Ejemplo de uso

Puedes interactuar con el agente IA para realizar consultas sobre tu sistema de forma natural, como si estuvieras hablando con un asistente. Al hacerle preguntas, el agente analizará tu petición, ejecutará los comandos necesarios en el sistema y te devolverá una respuesta clara y estructurada, normalmente acompañada de explicaciones o tablas según corresponda.

Por ejemplo, puedes preguntarle:

  • ¿Qué discos tengo?
  • ¿Qué DNS tengo configurados?

El agente responderá mostrando la información relevante, como una lista de discos detectados, particiones, espacio disponible, o los servidores DNS configurados en tu sistema, todo presentado de manera fácil de entender.

Puedes añadir aquí una captura de pantalla de ejemplo de la respuesta del agente:

Ejemplo de respuesta del agente


Autor y licencia

  • Javier Lazaro
  • GPL