🔧 Configuración

JARVIS se configura mediante el archivo config.py en la raíz del proyecto. Todos los parámetros están documentados con comentarios y no requieren conocimientos avanzados para personalizarlos.

Archivo config.py — Visión general

El archivo se divide en secciones lógicas. A continuación se muestran los parámetros más importantes:

🧠 Modo Local vs. Cloud

JARVIS tiene un cerebro dual: puede funcionar con IA local en tu PC o conectándose a APIs cloud gratuitas. El parámetro BRAIN_MODE en config.py controla qué modo usar.

Cómo cambiar de modo

Puedes cambiar el modo de dos formas:

# Para usar cloud (recomendado):
BRAIN_MODE = "cloud"
CLOUD_PROVIDER = "github"   # o "gemini"

# Para usar local:
BRAIN_MODE = "local"
OLLAMA_MODEL = "mistral"    # o "llama3", "phi3"

"cambia al modo cloud"
"cambia al modo local"
"usa el proveedor gemini"
"usa el proveedor github"

Comparativa de proveedores cloud

🔑 Configurar API Keys

Las API keys son gratuitas y se necesitan solo si usas el modo cloud. Se guardan cifradas en data/config.json, nunca en el código fuente.

GitHub Models (GPT-4o-mini)

"configura api key github ghp_TuTokenAquí123456789"

Google Gemini (Gemini 2.0 Flash)

"configura api key gemini AIzaSy_TuKeyAquí123456789"

🔌 Sistema de Plugins

JARVIS soporta un sistema de plugins que permite extender sus funcionalidades sin tocar el código base. Los plugins se colocan en la carpeta plugins/.

Crear un plugin

def register():
    return {
        "nombre": "Mi Plugin",
        "version": "1.0",
        "comandos": {
            "saludo especial": saludar,
        }
    }

def saludar(params):
    return "¡Hola desde mi plugin personalizado!"

🧠 Memoria y Aprendizaje

JARVIS tiene un sistema de memoria persistente y de aprendizaje que le permite mejorar con cada interacción.

Memoria (SQLite)

• Se almacena en data/memory.db
• Guarda el historial de conversaciones anteriores
• Permite a JARVIS recordar preferencias del usuario
• Ejemplo: "recuerda que mi color favorito es el azul" → JARVIS lo guarda y lo recuerda en futuras sesiones

Procedimientos aprendidos

• Se guardan en data/procedures.json
• Cuando JARVIS completa una tarea autónoma con éxito (ej.: enviar un WhatsApp), guarda los pasos para ejecutarlos más rápido la próxima vez
• Solo se guardan procedimientos que superan la validación de coherencia (los pasos deben corresponder al objetivo original)
• Se pueden listar con "qué procedimientos conoces"

Habilidades aprendidas

• Se guardan en data/learned_skills.json
• Cuando JARVIS no sabe hacer algo, puede investigar autónomamente cómo hacerlo, generar código Python, probarlo y guardar la habilidad si funciona
• Ejemplo: "aprende a obtener el clima de mi ciudad" → investiga APIs, genera código, lo prueba, y guarda la habilidad
• Las habilidades se reutilizan automáticamente en futuras sesiones
• Listar: "qué has aprendido" — Olvidar: "olvida la habilidad X"

Archivos de datos