Documentación de RinariPrimeros pasos
Conectar un proveedor
Agrega un proveedor de modelos, prueba la conexión, descubre sus modelos y dales un alias para elegirlos en el composer.
Estás aquí
Rinari necesita un proveedor de modelos para trabajar. La conexión la pones tú —una API en la nube, una suscripción o un modelo en tu propio equipo— y la guarda el motor, así que la app de escritorio y la CLI comparten los mismos proveedores y credenciales.
Primer arranque
La primera vez, la app abre Configura tu proveedor, que tiene cinco pasos:
- Elige un preset: el tipo de proveedor.
- Conexión: endpoint y autenticación.
- Probar y descubrir: comprueba la conexión y lee el catálogo de modelos.
- Elige tus modelos: los que quieres usar.
- Listo: a conversar.
Configurar después salta el asistente. Puedes agregar proveedores cuando quieras desde Ajustes → Proveedores.
Agregar un proveedor
En Ajustes → Proveedores, elige Agregar proveedor y un preset. La lista la da el motor e incluye:
- OpenAI y Anthropic;
- OpenRouter, Google Gemini, DeepSeek, Mistral, xAI (Grok), Groq, Together AI, DeepInfra, Fireworks, OpenCode Zen y OpenCode Go, Z.ai, Moonshot / Kimi y MiniMax;
- Ollama y LM Studio, para modelos locales;
- Custom endpoint, para cualquier otra API compatible con OpenAI.
ChatGPT (suscripción, acceso a Codex) y GitHub Copilot inician sesión en tu navegador en lugar de usar una API key. Los dos están marcados como experimentales.
Claude Subscription (experimental)
Claude Subscription usa tu plan de Claude a través del CLI oficial de Claude Code, que tiene que estar instalado en tu equipo. Está apagado por defecto: actívalo con el interruptor Claude Subscription (experimental) en Ajustes → Proveedores y aparece entre los proveedores que puedes agregar. Al apagarlo, los guardados dejan de usarse. Si Claude Code aún no está instalado, el proveedor te guía para instalarlo.
Las herramientas de Rinari —archivos, terminal y las demás— funcionan con él, y pasan siempre por Rinari, con sus permisos, aprobaciones y actividad. Claude Code no ejecuta nada por su cuenta. Desde una terminal: rinari providers add --claude-subscription.
Un preset rellena el endpoint por ti. Para un endpoint propio, escribe su URL base.
Autenticación
Elige cómo obtiene el motor la credencial:
| Opción | Cómo funciona |
|---|---|
| API key | La clave se guarda en el almacén de secretos del motor y no queda en el navegador. |
| Variable de entorno | Escribe el nombre de la variable (por ejemplo OPENAI_API_KEY), no su valor. El motor la resuelve en su propio proceso. |
| Sin autenticación (local) | Para servidores locales como Ollama o LM Studio. |
Las credenciales pertenecen al motor, no a la interfaz de la app, y nunca se escriben en el almacenamiento del navegador del frontend.
Probar y descubrir modelos
Probar comprueba la conexión y dice cuántos modelos encontró. Descubrir modelos lee el catálogo del proveedor.
Descubrir modelos demuestra que el catálogo es accesible. La generación, las herramientas y la visión necesitan sus propias comprobaciones, así que un modelo que aparece en la lista puede fallar en un turno real; por ejemplo, si no admite herramientas.
Guardar modelos con un alias
Guarda los modelos que quieras con un alias: el nombre visible que verás en el composer. El modelo de cada conversación se elige en el composer, junto con su nivel de razonamiento cuando el modelo lo admite.
Nivel de razonamiento
El chip de razonamiento, junto al modelo, abre un deslizador de Más rápido a Más inteligente: Predeterminado y niveles hasta Muy alto, Máximo y Ultra en modelos compatibles.
Los niveles dependen del modelo y del proveedor. Si un modelo no declara cuáles admite, el proveedor valida tu selección.
Cambiar el proveedor o el modelo activo nunca borra la configuración de los demás; cada proveedor recuerda su último modelo.
Modelos locales
Los presets locales apuntan a la dirección predeterminada de cada servidor:
| Servidor | Endpoint predeterminado |
|---|---|
| Ollama | http://localhost:11434/v1 |
| LM Studio | http://localhost:1234/v1 |
El servidor tiene que estar en marcha antes de probar la conexión, y el modelo tiene que estar cargado o disponible. Los modelos locales necesitan hardware adecuado, y muchos modelos pequeños no manejan bien las herramientas.
Desde la terminal
La CLI usa la misma configuración del motor. Para configurar un proveedor desde una terminal:
rinari setup
rinari providers list
rinari providers test <alias>rinari doctor revisa tu instalación sin tocar credenciales ni estado.
Costes y datos
Los proveedores remotos pueden cobrar por uso. Que la app sea de escritorio no hace que todas las tareas sean locales: los modelos en la nube y las herramientas externas envían datos a los servicios que configures.
Siguiente: abre tu primer proyecto. Para darles modelos propios a los agentes integrados de Rinari, consulta Subagentes.