[DOCS] Actualizada documentación de Sora

- Actualizada documentación para reflejar el cambio de alias a script directo

- Añadida información sobre el modo local con Ollama

- Agregados detalles sobre evaluación de hardware

- Reorganizada sección de modos de ejecución

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Mauro Rosero P. 2025-04-07 20:45:47 -05:00
parent 08f449ab31
commit 5c5e31401f
Signed by: mrosero
GPG key ID: 83BD2A5F674B7E26
2 changed files with 70 additions and 35 deletions

View file

@ -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 - **Pair Programming**: Trabaja directamente con tus repositorios Git
- **Edición Colaborativa**: Modifica archivos existentes aplicando cambios automáticamente - **Edición Colaborativa**: Modifica archivos existentes aplicando cambios automáticamente
- **Integración con Git**: Crea commits, ramas y gestiona cambios con instrucciones naturales - **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 - **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 ### 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" 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: 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 > Añade validación de datos a todos los formularios y manejo de errores
``` ```

View file

@ -20,10 +20,7 @@ Implementada como parte del ecosistema MRDevs Tools, Sora facilita la codificaci
```bash ```bash
# Instalar Sora # Instalar Sora
bin/aider_install.sh bin/sora_install.sh
# Configurar alias para facilitar su uso
bin/sora_enable.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: 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 ```bash
# Actualizar Sora a la última versión # Actualizar Sora a la última versión
bin/aider_install.sh --update bin/sora_install.sh --update
# Desinstalar Sora completamente # Desinstalar Sora completamente
bin/aider_install.sh -u bin/sora_install.sh -u
# Deshabilitar temporalmente el alias 'sora'
bin/sora_disable.sh
``` ```
## Uso Básico ## Uso Básico
@ -56,18 +50,18 @@ Para comenzar a trabajar con Sora en un repositorio existente:
# Navegar al directorio del repositorio # Navegar al directorio del repositorio
cd /ruta/a/tu/proyecto cd /ruta/a/tu/proyecto
# Iniciar Sora (usando alias) # Iniciar Sora
sora bin/sora.sh
``` ```
También puedes especificar archivos específicos para trabajar: También puedes especificar archivos específicos para trabajar:
```bash ```bash
# Iniciar Sora con archivos específicos # 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 # Iniciar Sora con un patrón glob
sora "src/*.py" bin/sora.sh "src/*.py"
``` ```
### Interacción Básica ### Interacción Básica
@ -103,50 +97,50 @@ Sora puede trabajar con archivos de diferentes formas:
```bash ```bash
# Editar archivos existentes # Editar archivos existentes
sora --edit archivo.py bin/sora.sh --edit archivo.py
# Crear nuevos archivos # 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) # 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 ```bash
# Usar un modelo específico de OpenAI # Al iniciar sora.sh, se te presentará un selector:
sora --model gpt-4 bin/sora.sh
# Usar un modelo de Anthropic # Opciones disponibles:
sora --model claude-3-opus-20240229 # 1. Remoto (OpenRouter) - Usa modelos en la nube
# 2. Local (Ollama) - Usa modelos instalados localmente
# Ver modelos disponibles
sora --help models
``` ```
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 ### Comunicación con LLM por Voz
```bash ```bash
# Activar entrada por voz (experimental) # Activar entrada por voz (experimental)
sora --voice bin/sora.sh --voice
# Especificar idioma para reconocimiento de voz # Especificar idioma para reconocimiento de voz
sora --voice --language es-ES bin/sora.sh --voice --language es-ES
``` ```
### Personalización del Comportamiento ### Personalización del Comportamiento
```bash ```bash
# Controlar verbose del LLM # Controlar verbose del LLM
sora --verbose # Muestra proceso de pensamiento detallado bin/sora.sh --verbose # Muestra proceso de pensamiento detallado
sora --concise # Respuestas breves y directas bin/sora.sh --concise # Respuestas breves y directas
# Modificar la creatividad de las respuestas # Modificar la creatividad de las respuestas
sora --temperature 0.7 # Más creativo (0.0-1.0) bin/sora.sh --temperature 0.7 # Más creativo (0.0-1.0)
sora --temperature 0.2 # Más determinista bin/sora.sh --temperature 0.2 # Más determinista
``` ```
## Flujos de Trabajo Comunes ## Flujos de Trabajo Comunes
@ -504,6 +498,26 @@ sora arquitectura.md
> Implementa el servicio de autenticación descrito en este documento > 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 ## Comparación de Modelos de IA
Sora es compatible con diversos modelos de IA, cada uno con sus fortalezas particulares: 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 ```bash
# Plugin para análisis estático # Plugin para análisis estático
sora --plugin static-analysis bin/sora.sh --plugin static-analysis
# Plugin para benchmarking # 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 ## 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. 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.