Configura CerebrIA desde cero
Tanto si quieres privacidad total con Ollama como si prefieres la potencia de OpenAI o Claude, esta guía te lleva de la mano paso a paso. No se necesitan conocimientos técnicos previos.
¿Por dónde empiezo?
Elige la opción que mejor se adapte a ti
Quiero privacidad total
Ollama · Todo se procesa en tu ordenador. Sin cuentas, sin API keys, sin costes por uso. Necesitas un PC con al menos 16 GB de RAM.
Recomendado para privacidadQuiero la mejor calidad
OpenAI GPT-5.x · Modelos de mayor capacidad. Requiere crear una cuenta y añadir método de pago. Pago por uso.
Mejor calidad generalTextos largos y técnicos
Claude · Excelente para documentación extensa, análisis técnico y razonamiento complejo. Requiere cuenta en Anthropic.
Mejor para documentos técnicosQuiero bajo coste
DeepSeek · Alto rendimiento a fracción del coste de OpenAI. Ideal para uso intensivo. Requiere cuenta en DeepSeek.
Mejor relación calidad/precioOllama · IA 100% local
Sin internet, sin cuentas, sin costes por uso. Tus datos nunca salen de tu ordenador.
Requisitos mínimos del sistema
32 GB recomendado
por modelo descargado
GPU opcional pero mejora mucho la velocidad
macOS o Linux también
Recomendación práctica de hardware (RAG local)
CPU potente + 32 GB RAM
16 GB VRAM para 20B-27B cuantizados
RTX 5060 Ti 16 GB o superior
RX 9070 o superior (válida)
Referencia: para ir realmente holgado, una RTX 4090 o una RX 7900 XTX van muy bien, pero normalmente se salen del perfil de presupuesto objetivo.
Instalación paso a paso
Descarga Ollama
Abre tu navegador y ve a ollama.com. Haz clic en el botón de descarga para Windows (o tu sistema operativo).
https://ollama.com/download
Es software libre y de confianza. El instalador pesa aproximadamente 80 MB.
Instala Ollama
Ejecuta el instalador descargado (OllamaSetup.exe). El instalador es sencillo: acepta los términos y haz clic en "Install". No necesitas cambiar ninguna opción.
Descarga un modelo de lenguaje (LLM)
Abre el Símbolo del sistema (busca "cmd" en el menú inicio) o PowerShell y ejecuta:
ollama pull llama3.2
Esto descarga el modelo Llama 3.2 (3B parámetros, ~2 GB). Es un modelo excelente para empezar.
La descarga puede tardar varios minutos según tu conexión. El progreso se muestra en la terminal.
Descarga un modelo de embeddings
Los embeddings son necesarios para que CerebrIA entienda el contenido de tus documentos. Descarga el modelo recomendado para Ollama:
ollama pull bge-m3
bge-m3 ofrece muy buen equilibrio para búsqueda semántica multilingüe. Si priorizas ligereza, nomic-embed-text sigue siendo una alternativa válida.
Verifica que Ollama funciona
Abre tu navegador y ve a:
http://localhost:11434
Si ves el texto "Ollama is running", ¡todo está listo!
ollama serve para iniciar el servicio manualmente.Configura CerebrIA para usar Ollama
En CerebrIA, ve a Configuración → Proveedor de IA y selecciona:
http://localhost:11434
llama3.2 (o el que hayas descargado)
bge-m3
OpenAI · GPT-5.x
El proveedor más popular. Excelente equilibrio entre calidad, velocidad y facilidad de uso.
Obtener tu API Key de OpenAI
Crea una cuenta en OpenAI
Ve a la plataforma de desarrollo de OpenAI:
https://platform.openai.com/signup
Puedes registrarte con tu email, o con tu cuenta de Google o Microsoft. Elige la opción que prefieras.
Añade un método de pago
Sin crédito, las llamadas a la API no funcionan. Ve a:
platform.openai.com → Billing → Add payment method
Añade tu tarjeta de crédito/débito. OpenAI solo cobra lo que uses. Te recomendamos configurar un límite de gasto (Usage limits) de 5-10 € al mes para empezar.
Genera tu API Key
En el panel de OpenAI, ve a:
platform.openai.com → API keys → Create new secret key
Dale un nombre descriptivo (por ejemplo, "CerebrIA") y haz clic en Create secret key.
sk-... y tiene unos 50 caracteres. Cópiala y guárdala en un lugar seguro antes de cerrar la ventana.Configura CerebrIA con tu clave
En CerebrIA, ve a Configuración → Proveedor de IA:
gpt-5-mini (recomendado)
sk-proj-XXXXXXXXXXXX...
text-embedding-3-small
Claude · Anthropic
Excepcional para documentación técnica, razonamiento complejo y textos muy largos.
Obtener tu API Key de Anthropic
Crea una cuenta en Anthropic
https://console.anthropic.com/
Regístrate con tu email. Anthropic puede pedirte verificación por teléfono.
Añade créditos
Sin crédito, la API no funciona. Ve a:
console.anthropic.com → Billing → Add credit
Puedes añadir desde 5 USD. Claude también ofrece una pequeña cantidad de créditos gratuitos al registrarte.
Genera tu API Key
console.anthropic.com → API Keys → Create Key
sk-ant-.... Al igual que con OpenAI, cópiala nada más crearla y guárdala en un lugar seguro.Configura CerebrIA
claude-sonnet-4-6 (recomendado)
sk-ant-XXXXXXXXXXXX...
DeepSeek
Alto rendimiento a un coste hasta 10× menor que OpenAI. Ideal para uso intensivo.
Obtener tu API Key de DeepSeek
Crea una cuenta en DeepSeek
https://platform.deepseek.com/sign_up
Regístrate con tu email y verifica tu cuenta.
Recarga tu saldo
platform.deepseek.com → Top Up
El mínimo es generalmente 2 USD, que dará para miles de consultas.
Genera tu API Key
platform.deepseek.com → API Keys → Create API Key
La clave empieza por sk-.... Cópiala y guárdala.
Configura CerebrIA
deepseek-chat (recomendado)
sk-XXXXXXXXXXXX...
¿Qué son los embeddings y por qué importan?
La decisión más importante antes de ingestar tus documentos
Explicación sencilla
Imagina que tienes una biblioteca enorme con miles de libros. Para encontrar información, necesitas un índice que entienda el significado de cada párrafo, no solo las palabras exactas.
Los embeddings son ese índice: un proceso que traduce cada fragmento de texto en una lista de números que captura su "significado". Cuando haces una pregunta, CerebrIA convierte tu pregunta en el mismo tipo de números y busca los fragmentos más parecidos.
El modelo de embeddings es el motor que hace esa traducción. Distintos modelos producen distintos tipos de números, y son incompatibles entre sí.
Si empiezas con bge-m3 de Ollama y luego cambias a text-embedding-3-small de OpenAI, los números que tenía guardados ya no son válidos. CerebrIA detectará el cambio automáticamente y te pedirá confirmación, pero el proceso de reingestión puede llevar horas si tienes muchos documentos.
Elige bien desde el principio y no cambies salvo que sea necesario.
¿Qué modelo de embeddings elegir?
Dimensiones de los modelos de embeddings
Las dimensiones son el "tamaño" del índice. Más dimensiones = más preciso, pero más espacio en disco.
bge-m3 ⭐Ollama1 024~4 KB
nomic-embed-textOllama768~3 KB
text-embedding-3-smallOpenAI1 536~6 KB
DeepSeek EmbeddingsDeepSeek1 024~4 KB
Preguntas frecuentes
Respuestas a las dudas más comunes
¿Puedo usar CerebrIA sin internet?
Sí, si usas Ollama como proveedor de LLM y embeddings. Con OpenAI, Claude o DeepSeek necesitas conexión a internet para cada consulta, ya que la IA se ejecuta en sus servidores.
¿Son seguras mis API Keys?
CerebrIA guarda tus claves en el fichero de configuración local de tu ordenador (appsettings.json o similar). Nunca se envían a ningún servidor de CerebrIA. Las claves se usan únicamente para comunicarse directamente con OpenAI/Anthropic/DeepSeek desde tu máquina.
Buenas prácticas: no compartas el fichero de configuración, no subas las claves a GitHub y actívalas o desactívalas desde el panel del proveedor si sospechas que se han comprometido.
Ollama es muy lento en mi PC. ¿Qué puedo hacer?
La velocidad de Ollama depende del hardware. Algunas opciones:
- Usa un modelo más pequeño:
llama3.2:3ben lugar de modelos de 8B o 70B. - Si tienes GPU NVIDIA, asegúrate de que Ollama la detecta (instala los drivers CUDA).
- Cierra otras aplicaciones que consuman RAM mientras usas CerebrIA.
- Considera usar OpenAI o DeepSeek si la velocidad es prioritaria.
¿Puedo cambiar el LLM sin perder mis documentos?
Sí. Cambiar de LLM (por ejemplo, pasar de OpenAI a Claude) es completamente seguro y no afecta a tus documentos ni a los embeddings. Puedes cambiarlo en cualquier momento desde Configuración.
¿Qué pasa si cambio el modelo de embeddings?
Es la operación más crítica. Si cambias el modelo de embeddings, todos los documentos ya indexados deben ser eliminados y reingresados desde cero. Esto puede tardar desde minutos hasta horas dependiendo del número de documentos.
CerebrIA detecta automáticamente si el modelo configurado no coincide con el del índice y te avisa antes de que ocurra un error. Sigue las instrucciones de la interfaz en ese momento.
He ingresado documentos pero las respuestas no son buenas. ¿Por qué?
Varias causas posibles:
- Calidad del PDF: PDFs escaneados (imágenes) no se leen bien. Usa el modo de refinamiento automático para limpiar el texto.
- Modelo muy pequeño: Con Ollama, los modelos de 3B tienen capacidad limitada. Prueba con
llama3.1:8bsi tu PC lo permite. - Pregunta demasiado vaga: Intenta ser más específico, incluye términos clave del documento.
- Dominio incorrecto: Verifica que estás buscando en el dominio correcto.
¿Cómo sé que Ollama está funcionando?
Abre el navegador y ve a http://localhost:11434. Si ves "Ollama is running", está activo. También puedes comprobar la lista de modelos instalados ejecutando en la terminal:
ollama list
Esto muestra todos los modelos descargados y disponibles.
¿Puedo usar un LLM de un proveedor y embeddings de otro?
Sí. CerebrIA está diseñado exactamente para esto. Por ejemplo, puedes usar:
- Claude (LLM) + OpenAI text-embedding-3-small (embeddings) — combina lo mejor de ambos
- Ollama/llama3 (LLM) + OpenAI text-embedding-3-small (embeddings) — LLM local con mejor indexado
- OpenAI GPT-4 (LLM) + Ollama bge-m3 (embeddings) — ahorra coste en embeddings
La única restricción es que, una vez elegido el modelo de embeddings, no debes cambiarlo sin reingestar los documentos.
¿Mis documentos se guardan en la nube?
No. CerebrIA es una aplicación de escritorio local. Tus documentos, embeddings y base de datos vectorial (Qdrant) se almacenan íntegramente en tu ordenador.
Si usas OpenAI, Claude o DeepSeek, los fragmentos de texto de los documentos sí se envían a sus servidores para generar los embeddings y las respuestas. Si esto no es aceptable, usa Ollama para todo.
¿Todo listo para empezar?
Descarga CerebrIA, elige tu proveedor favorito y empieza a hacer preguntas a tus documentos en minutos.