rudra496/nexus-agent

¿Qué hace nexus-agent?

⚡ Nexus Agent — Framework de agente de IA local, autoevolutivo y sin configuración. Orquestación multiagente, GraphRAG, integración con IDE. Funciona 100 % local con Ollama.

Características principales

• Configuración cero: Despliega y usa el agente inmediatamente después de la instalación. No requiere configuración manual.
• Autoevolutivo: El agente aprende y mejora automáticamente a partir de las interacciones y el uso continuo.
• Multiagente: Orquestación de múltiples instancias de IA para colaborar en tareas complejas.
• GraphRAG: Combina bases de datos de grafos con Recuperación Aumentada por Generación para un acceso eficiente a conocimiento estructurado.
• Integración con IDE: Funciona como extensión en tu editor de código favorito (VS Code, Neovim, etc.).
• 100 % local: Se ejecuta completamente en tu equipo con Ollama. Sin dependencias externas ni envío de datos a la nube.

¿Cómo empezar?

1. Instala Ollama y descarga un modelo base (por ejemplo, ollama pull llama3 o mistral).
2. Clona el repositorio:

git clone https://github.com/rudra496/nexus-agent
cd nexus-agent

3. Instala las dependencias:

pip install -r requirements.txt

4. Inicia el agente:

python run_agent.py --model llama3

5. (Opcional) Habilita la integración con tu IDE mediante la extensión correspondiente.

Requisitos del sistema

• Sistema operativo: Linux, macOS, Windows (con WSL2)
• RAM: 8 GB mínimo; 16 GB recomendado
• Espacio en disco: 2 GB para el agente + espacio para los modelos de Ollama
• Python: 3.10 o superior

Arquitectura

Nexus Agent utiliza una arquitectura modular con los siguientes componentes principales:

• Orquestador: Gestiona la comunicación entre agentes y la ejecución de tareas paralelas.
• Motor GraphRAG: Indexa y recupera conocimiento de documentos, código y bases de datos graficas.
• Capa de integración: Proporciona APIs REST, SDK y conectores para IDE.
• Bucle de evolución: Monitorea el rendimiento del agente y adapta parámetros, prompts y estrategias.

Integraciones

• Ollama: Backend de inferencia local principal.
• llama.cpp: Backend alternativo para modelos cuantizados.
• VS Code: Extensión oficial para usar agentes desde el editor.
• Neovim: Plugin Lua para integración nativa.
• API REST: Endpoint HTTP para integrar desde otras aplicaciones.
• CLI: Herramienta de línea de comandos para scripting y automatización.

Licencia

MIT License. Ver LICENSE para más detalles.

---

Creado por rudra496 — ¡Contribuciones y retroalimentación bienvenidas!