Asistente de configuracion inicial

El comando prx onboard crea tu archivo de configuracion inicial guiandote a traves de la seleccion de proveedor, ingreso de clave API, eleccion de modelo y configuracion del backend de memoria. Es la forma recomendada de configurar PRX por primera vez.

Que hace Onboard

Cuando ejecutas prx onboard, el asistente realiza los siguientes pasos:

1. Selecciona un proveedor de LLM -- Te solicita elegir entre los 9 proveedores soportados (Anthropic, OpenAI, Google Gemini, Ollama, OpenRouter, etc.)
2. Almacena tu clave API -- Escribe de forma segura tu credencial del proveedor en el archivo de configuracion
3. Obtiene los modelos disponibles -- Consulta la API del proveedor para listar los modelos a los que tienes acceso
4. Establece un modelo por defecto -- Te permite elegir el modelo a usar por defecto
5. Configura el backend de memoria -- Elige entre Markdown (basado en archivos), SQLite o PostgreSQL
6. Escribe el archivo de configuracion -- Crea ~/.config/openprx/openprx.toml con tus ajustes

Despues de la configuracion inicial, PRX esta listo para ejecutarse con prx daemon o prx chat.

Modo interactivo

La experiencia de configuracion inicial por defecto es la configuracion rapida, que solo hace preguntas esenciales. Para un asistente interactivo completo que recorra cada seccion de configuracion, usa la opcion --interactive:

prx onboard --interactive

El asistente interactivo incluye configuracion adicional para:

• Ajustes de host y puerto del gateway
• Pre-configuracion de canales (Telegram, Discord, etc.)
• Nivel de seguridad y autonomia
• Directorio del espacio de trabajo
• Ajustes de observabilidad

Configuracion rapida (Por defecto)

El prx onboard por defecto ejecuta una configuracion rapida simplificada:

prx onboard

Esto pregunta por tu proveedor, clave API y modelo -- nada mas. Todos los demas ajustes usan valores predeterminados razonables.

Configuracion rapida con opciones

Omite completamente las preguntas interactivas pasando opciones:

prx onboard \
  --provider anthropic \
  --api-key sk-ant-api03-xxxxxxxxxxxx \
  --model claude-sonnet-4-20250514

Opciones disponibles:

Opcion	Descripcion	Ejemplo
--provider	Nombre del proveedor de LLM	anthropic, openai, ollama, openrouter
--api-key	Clave API o credencial del proveedor	sk-ant-..., sk-...
--model	Identificador del modelo por defecto	claude-sonnet-4-20250514, gpt-4o
--memory	Backend de memoria	markdown, sqlite, postgres
--interactive	Ejecutar el asistente interactivo completo	(sin valor)
--channels-only	Re-ejecutar solo el asistente de reparacion de canales	(sin valor)

Ejemplos

Anthropic Claude con valores por defecto:

prx onboard --provider anthropic --api-key "$ANTHROPIC_API_KEY"

Ollama local (no requiere clave API):

prx onboard --provider ollama --model llama3.2

OpenRouter con un modelo especifico:

prx onboard --provider openrouter --api-key "$OPENROUTER_API_KEY" --model anthropic/claude-sonnet-4-20250514

OpenAI con memoria SQLite:

prx onboard --provider openai --api-key "$OPENAI_API_KEY" --model gpt-4o --memory sqlite

Archivo de configuracion

El asistente de configuracion inicial escribe la configuracion en:

~/.config/openprx/openprx.toml

En Linux, esto sigue la especificacion XDG Base Directory. En macOS, usa ~/Library/Application Support/openprx/openprx.toml a menos que XDG_CONFIG_HOME este configurado.

Ejemplo de configuracion generada

Despues de ejecutar prx onboard --provider anthropic --model claude-sonnet-4-20250514, la configuracion generada se ve asi:

# OpenPRX Configuration
# Generated by: prx onboard

# ── Provider ──────────────────────────────────────────────
default_provider = "anthropic"
default_model = "claude-sonnet-4-20250514"
default_temperature = 0.7
api_key = "sk-ant-api03-xxxxxxxxxxxx"

# ── Workspace ─────────────────────────────────────────────
workspace_dir = "~/.local/share/openprx"

# ── Memory ────────────────────────────────────────────────
[memory]
backend = "markdown"
# path defaults to workspace_dir/memory

# ── Gateway ───────────────────────────────────────────────
[gateway]
host = "127.0.0.1"
port = 3120

# ── Channels ──────────────────────────────────────────────
[channels]
cli = true

# ── Security ──────────────────────────────────────────────
[security]
autonomy = "supervised"

Puedes editar este archivo en cualquier momento. PRX soporta recarga en caliente -- la mayoria de los cambios surten efecto sin reiniciar el demonio.

Secciones de configuracion

El archivo de configuracion soporta las siguientes secciones de nivel superior:

Seccion	Proposito
default_provider	Proveedor de LLM a usar por defecto
default_model	Modelo a usar por defecto
api_key	Credencial API del proveedor
[memory]	Backend de memoria y ajustes de almacenamiento
[gateway]	Configuracion del gateway HTTP/WebSocket
[channels]	Configuraciones de canales de mensajeria
[channels.telegram]	Ajustes del bot de Telegram
[channels.discord]	Ajustes del bot de Discord
[security]	Nivel de autonomia, sandbox, politicas
[router]	Estrategia de enrutamiento de LLM
[self_system]	Ajustes del pipeline de autoevolucion
[observability]	Metricas, trazado, logging
[cron]	Configuracion de tareas programadas
[plugins]	Rutas y ajustes de plugins WASM

Consulta la Referencia completa de configuracion para todas las opciones disponibles.

Verificacion posterior a la configuracion

Despues de la configuracion inicial, ejecuta el comando de diagnostico para verificar que todo esta configurado correctamente:

prx doctor

El doctor comprueba:

• Archivo de configuracion -- Valida la sintaxis TOML y los campos requeridos
• Conectividad del proveedor -- Prueba la clave API consultando al proveedor
• Disponibilidad del modelo -- Confirma que el modelo seleccionado es accesible
• Backend de memoria -- Verifica que el backend de almacenamiento es escribible
• Dependencias del sistema -- Comprueba herramientas opcionales (git, docker, etc.)
• Red -- Prueba la conectividad con los servicios configurados

Ejemplo de salida:

PRX Doctor

  Config file .............. OK  (~/.config/openprx/openprx.toml)
  Provider (anthropic) ..... OK  (authenticated)
  Model .................... OK  (claude-sonnet-4-20250514)
  Memory (markdown) ........ OK  (writable)
  Gateway port (3120) ...... OK  (available)
  Git ...................... OK  (2.43.0)
  Docker ................... WARN (not installed -- sandbox features limited)

All critical checks passed.

Subcomandos de Doctor

El doctor tambien tiene subcomandos para diagnosticos especificos:

# Sondear catalogos de modelos de todos los proveedores
prx doctor models

# Sondear modelos de un proveedor especifico
prx doctor models --provider anthropic

Asistente de reparacion de canales

Si ya completaste la configuracion inicial y quieres agregar o arreglar configuraciones de canales, usa la opcion --channels-only:

prx onboard --channels-only

Esto omite la configuracion de proveedor y modelo y va directamente a la configuracion de canales.

Re-ejecutar Onboard

Puedes ejecutar prx onboard nuevamente en cualquier momento. El asistente detecta tu configuracion existente y ofrece actualizarla en lugar de sobrescribirla desde cero. Tus configuraciones de canales existentes, datos de memoria y ajustes personalizados se preservan.

Siguientes pasos

• Inicio rapido -- Inicia el demonio y chatea
• Canales -- Conecta plataformas de mensajeria
• Referencia de configuracion -- Lista completa de todas las opciones de configuracion