[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:
parent
08f449ab31
commit
5c5e31401f
2 changed files with 70 additions and 35 deletions
|
@ -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
|
||||
```
|
||||
|
||||
|
|
100
docs/sora.md
100
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.
|
||||
|
|
Loading…
Reference in a new issue