diff --git a/README.md b/README.md index 7380f0b..467c0bc 100644 --- a/README.md +++ b/README.md @@ -35,8 +35,9 @@ Nuestros asistentes de IA están diseñados para acelerar y mejorar el ciclo de - **Pair Programming**: Trabaja directamente con tus repositorios Git - **Edición Colaborativa**: Modifica archivos existentes aplicando cambios automáticamente - **Integración con Git**: Crea commits, ramas y gestiona cambios con instrucciones naturales + - **Modos Flexible**: Conecta con servicios en la nube (OpenRouter) o ejecuta modelos localmente (Ollama) + - **Evaluación de Hardware**: Analiza y muestra la capacidad del sistema para ejecutar modelos locales - **Desarrollo Multidocumento**: Comprende y modifica sistemas completos de múltiples archivos - - **Seguimiento de Contexto**: Mantiene el estado de la conversación para desarrollos complejos ### Casos de Uso Principales @@ -45,7 +46,7 @@ Nuestros asistentes de IA están diseñados para acelerar y mejorar el ciclo de cortana "Crea una API REST en Express.js para gestionar una biblioteca con préstamos" # Sora: Modificación de código existente en repositorio -sora src/*.js +bin/sora.sh src/*.js > Añade validación de datos a todos los formularios y manejo de errores ``` diff --git a/docs/sora.md b/docs/sora.md index 7008ced..9032dd2 100644 --- a/docs/sora.md +++ b/docs/sora.md @@ -20,10 +20,7 @@ Implementada como parte del ecosistema MRDevs Tools, Sora facilita la codificaci ```bash # Instalar Sora -bin/aider_install.sh - -# Configurar alias para facilitar su uso -bin/sora_enable.sh +bin/sora_install.sh ``` El proceso de instalación configura automáticamente todo lo necesario. Si necesitas configurar manualmente un token de API para algún proveedor compatible: @@ -37,13 +34,10 @@ bin/ai_token.sh ```bash # Actualizar Sora a la última versión -bin/aider_install.sh --update +bin/sora_install.sh --update # Desinstalar Sora completamente -bin/aider_install.sh -u - -# Deshabilitar temporalmente el alias 'sora' -bin/sora_disable.sh +bin/sora_install.sh -u ``` ## Uso Básico @@ -56,18 +50,18 @@ Para comenzar a trabajar con Sora en un repositorio existente: # Navegar al directorio del repositorio cd /ruta/a/tu/proyecto -# Iniciar Sora (usando alias) -sora +# Iniciar Sora +bin/sora.sh ``` También puedes especificar archivos específicos para trabajar: ```bash # Iniciar Sora con archivos específicos -sora archivo1.py archivo2.js +bin/sora.sh archivo1.py archivo2.js # Iniciar Sora con un patrón glob -sora "src/*.py" +bin/sora.sh "src/*.py" ``` ### Interacción Básica @@ -103,50 +97,50 @@ Sora puede trabajar con archivos de diferentes formas: ```bash # Editar archivos existentes -sora --edit archivo.py +bin/sora.sh --edit archivo.py # Crear nuevos archivos -sora --new "Crea un archivo HTML con un formulario básico" +bin/sora.sh --new "Crea un archivo HTML con un formulario básico" # Modo sólo lectura (no modifica archivos automáticamente) -sora --no-auto-commits archivo.py +bin/sora.sh --no-auto-commits archivo.py ``` -### Selección de Modelos +### Selección de Entorno y Modelos -Puedes especificar qué modelo de IA usar para la sesión: +Sora permite escoger entre distintos entornos de ejecución: ```bash -# Usar un modelo específico de OpenAI -sora --model gpt-4 +# Al iniciar sora.sh, se te presentará un selector: +bin/sora.sh -# Usar un modelo de Anthropic -sora --model claude-3-opus-20240229 - -# Ver modelos disponibles -sora --help models +# Opciones disponibles: +# 1. Remoto (OpenRouter) - Usa modelos en la nube +# 2. Local (Ollama) - Usa modelos instalados localmente ``` +En modo local, Sora evaluará el rendimiento de tu hardware y te mostrará qué tan bien podrá ejecutar los modelos locales. + ### Comunicación con LLM por Voz ```bash # Activar entrada por voz (experimental) -sora --voice +bin/sora.sh --voice # Especificar idioma para reconocimiento de voz -sora --voice --language es-ES +bin/sora.sh --voice --language es-ES ``` ### Personalización del Comportamiento ```bash # Controlar verbose del LLM -sora --verbose # Muestra proceso de pensamiento detallado -sora --concise # Respuestas breves y directas +bin/sora.sh --verbose # Muestra proceso de pensamiento detallado +bin/sora.sh --concise # Respuestas breves y directas # Modificar la creatividad de las respuestas -sora --temperature 0.7 # Más creativo (0.0-1.0) -sora --temperature 0.2 # Más determinista +bin/sora.sh --temperature 0.7 # Más creativo (0.0-1.0) +bin/sora.sh --temperature 0.2 # Más determinista ``` ## Flujos de Trabajo Comunes @@ -504,6 +498,26 @@ sora arquitectura.md > Implementa el servicio de autenticación descrito en este documento ``` +## Modos de Ejecución + +Sora ofrece dos modos principales de ejecución, cada uno con sus propias ventajas: + +### Modo Remoto (OpenRouter) + +El modo remoto utiliza OpenRouter para acceder a diversos modelos de IA en la nube: + +- **Ventajas**: Acceso a modelos de alta capacidad, no requiere hardware potente local. +- **Desventajas**: Requiere conexión a internet, envía datos a servicios externos. +- **Uso recomendado**: Desarrollo general, tareas complejas, proyectos grandes. + +### Modo Local (Ollama) + +El modo local ejecuta modelos en tu propia máquina utilizando Ollama: + +- **Ventajas**: Privacidad total, funciona sin internet, control completo. +- **Desventajas**: Requiere hardware potente, modelos más limitados. +- **Uso recomendado**: Código sensible, entornos restringidos, trabajo offline. + ## Comparación de Modelos de IA Sora es compatible con diversos modelos de IA, cada uno con sus fortalezas particulares: @@ -521,12 +535,32 @@ Sora puede extenderse con plugins personalizados: ```bash # Plugin para análisis estático -sora --plugin static-analysis +bin/sora.sh --plugin static-analysis # Plugin para benchmarking -sora --plugin benchmark +bin/sora.sh --plugin benchmark ``` +## Características Adicionales + +### Evaluación de Hardware + +En modo local, Sora realiza un diagnóstico completo del hardware disponible: + +- **Análisis de CPU**: Verifica el número de núcleos disponibles +- **Evaluación de RAM**: Comprueba la memoria total y disponible +- **Detección de GPU**: Identifica tarjetas gráficas NVIDIA compatibles +- **Clasificación de Rendimiento**: Desde "Muy Malo" hasta "Excelente" + +### Interacción con Ollama + +Sora gestiona automáticamente Ollama: + +- **Arranque Automático**: Inicia Ollama cuando es necesario +- **Monitoreo de Estado**: Verifica que Ollama esté respondiendo correctamente +- **Selección Interactiva**: Permite elegir entre los modelos disponibles +- **Apagado Automático**: Detiene Ollama al finalizar si lo inició Sora + ## Créditos y Reconocimientos Sora está basado en Aider, una potente herramienta de pair programming con IA. Todas las capacidades de análisis y generación de código son proporcionadas por Aider, mientras que la integración en el ecosistema MRDevs Tools ha sido implementada por el equipo de MRDevs Tools para proporcionar una experiencia fluida y personalizada.