Configurar conexiones, modelos, claves y copias de perfiles.
Un perfil reúne proveedor, URL, clave API, modelo y ajustes de generación. Las herramientas nativas que se ofrecen al modelo son comunes a todos los perfiles y se eligen en Configuración › Agente. Pulsa el nombre del perfil en la cabecera para seleccionarlo, crearlo, editarlo o borrarlo. Puedes cambiar de perfil entre mensajes; el historial existente pasa al nuevo proveedor en los siguientes envíos.
El editor se organiza en capítulos desplegables (Conexión, Parámetros de ejecución WebGPU solo con WebLLM, Comportamiento, Servidores MCP y Navegador); cada capítulo plegado muestra un resumen de su contenido y sus avisos. En Servidores MCP marcas los servicios MCP externos que arranca el perfil al activarse; los demás servicios en marcha no se paran. Un aviso indica los que arranca el perfil: siguen en marcha hasta que los detengas, pero no se recuerdan para la siguiente sesión, como sí ocurre con los que inicias en Configuración › MCP. Si alguno no está configurado en el servidor local o no arranca, ZeroChat avisa.
En Navegador el perfil pide solo lo mínimo que necesita. Si no necesita nada, el modelo navega con la herramienta de Ajustes › Navegador, por defecto browser_action si Playwright está instalado. Con Playwright MCP necesario, mientras el perfil está activo, y en zerochat --prompt --profile, Playwright MCP es la herramienta de navegación y arranca con el navegador elegido: el propio de ZeroChat con uno de sus motores instalados, o tu Chrome, Edge o Chromium mediante la extensión. Con el propio de ZeroChat funciona por defecto aislado en memoria (--isolated, compatible con ejecuciones simultáneas); puedes indicar además un nombre de Almacenamiento persistente para conservar cookies y sesiones entre usos en ~/zerochat/playwright/profile/<motor>/<almacenamiento> (sin multitarea simultánea sobre el mismo nombre) y marcar Mostrar la ventana mientras el modelo navega. Si ya está en marcha con otro navegador, otro almacenamiento o sin la ventana pedida, se reinicia. El token de la extensión sigue siendo el de Ajustes › Navegador.
El editor incluye temperatura, instrucciones y razonamiento. Con Google Gemini la temperatura aparece desactivada y se usa la del modelo, porque Google retira los parámetros de muestreo personalizados. Guardar aplica los cambios; Bloquear cambios evita la edición habitual del perfil, pero no es un control de acceso al equipo.
Exportar descarga un HTML con los perfiles editables cifrados. Ábrelo para iniciar su importación en ZeroChat y confirma los cambios: se añaden perfiles nuevos y se actualizan los del mismo identificador. Espejo se conserva.
En Configuración → Cifrado puedes establecer una contraseña propia o volver a la predeterminada. La clave integrada de la aplicación es conocida; el cifrado predeterminado no protege secretos frente a quien accede al almacenamiento o a la copia. Con contraseña propia se conserva material de desbloqueo en el navegador durante 24 horas. Trata las copias como archivos sensibles y conserva la contraseña: no hay recuperación de claves olvidadas.
| Proveedor | Conexión | Requisito |
|---|---|---|
| OpenAI y compatibles | API de chat compatible; por ejemplo LM Studio, LocalAI o vLLM | URL del servidor, modelo y clave si la exige |
| Ollama | http://localhost:11434 | Servicio activo y origen permitido |
| OpenRouter | https://openrouter.ai/api/v1 | Clave API; cómo obtenerla |
| Anthropic Claude | https://api.anthropic.com/v1 o cualquier servidor con la API Messages (/v1/messages), como llama.cpp | Clave API si el servidor la exige |
| Google Gemini | Endpoint compatible con OpenAI | Clave API; cómo obtenerla |
| WebLLM | webllm://local | WebGPU y modelo descargado |
| Espejo | Simulación local | Sin clave ni inferencia |
La compatibilidad de chat no implica que todos los modelos admitan imágenes, herramientas o razonamiento. También intervienen CORS, permisos de red local y restricciones del navegador.
Los perfiles de red requieren una consulta satisfactoria antes de guardar. Las capacidades pueden proceder de metadatos o de inferencias a partir del modelo: una consulta correcta no garantiza que todas las operaciones posteriores funcionen.
En WebLLM puedes guardar un modelo ya descargado sin repetir Query. Para preparar otro, abre el catálogo y completa su descarga.
La lupa del selector consulta el modelo configurado y muestra su disponibilidad, contexto y diagnóstico de capacidades. Si falla, comprueba URL, clave, servicio en ejecución y acceso desde el navegador.
La visión se marca como comprobada o no soportada cuando el servidor declara qué entradas acepta el modelo (llama.cpp, LM Studio, Ollama y OpenRouter lo hacen); si no lo declara, se muestra la del adaptador o la que sugiere el nombre del modelo.
El diagnóstico ayuda a localizar problemas, pero no certifica la compatibilidad de cada función. Prueba una conversación sencilla antes de añadir imágenes o herramientas.
Si el navegador bloquea el acceso por CORS, permite el origen desde el que abres ZeroChat en la configuración de Ollama y reinicia su servicio. Para GitHub Pages, el origen es https://albalday.github.io.
# Linux / macOS
OLLAMA_ORIGINS="https://albalday.github.io" ollama serve
# Windows PowerShell
$env:OLLAMA_ORIGINS="https://albalday.github.io"
ollama serveSi Ollama ya se ejecuta como servicio, modifica el entorno de ese servicio en lugar de iniciar una segunda instancia. Para la interfaz local añade su origen exacto. Consulta la documentación de Ollama. CORS no sustituye autenticación ni resuelve todos los bloqueos de red local del navegador.
Espejo es un perfil de prueba de solo lectura que muestra el mensaje y la estructura de la petición normalizada, sin llamar a un modelo. Sirve para revisar la interfaz y el formato del envío.
No genera respuestas de IA ni valida un proveedor externo. Que Espejo funcione no prueba que la red o las credenciales estén bien configuradas.