[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
- **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
```

View file

@ -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.