Autoalojar Rikoo

Rikoo se ejecuta por completo en su infraestructura. Las conversaciones, los documentos, los secretos y las trazas permanecen en su propia base de datos y su propio almacenamiento de objetos, y las únicas llamadas salientes van a los proveedores de modelos y a las herramientas que usted configure.

Opciones de despliegue

Opción	Para qué usarla	Guía
Docker Compose	Una evaluación, una demo o un equipo pequeño en una sola máquina	Docker Compose
Kubernetes (Helm)	Producción: réplicas, almacenes de datos gestionados, políticas de red	Kubernetes (Helm)

Ambas vías ejecutan los mismos servicios. Infraestructura describe cada uno de ellos y lo que deben ofrecer los almacenes de datos de los que dependen.

Acceso al código fuente y a las imágenes

El repositorio de código fuente de Rikoo (Rikoo-app/rikoo) y las imágenes de contenedor aún no son públicos. Las dos guías siguientes requieren un acceso concedido por el equipo de Rikoo: solicítelo a través de rikoo.io/contact. El chart de Helm (Rikoo-app/rikoo-k8s) es público.

Arquitectura

            browsers, websites, Slack, API clients
                          │
                          ▼
   ┌──────────────────────────────────────────────┐
   │ api   REST, Studio, widget, auth, enqueueing  │── PostgreSQL + pgvector
   └──────────────────────────────────────────────┘── Redis
                          │ queues (Redis)          ── S3-compatible storage
                          ▼
   ┌──────────────────────────────────────────────┐
   │ worker   runs, model calls, retrieval, tools  │──► model providers, MCP servers
   └──────────────────────────────────────────────┘    (through the egress guard)
         │ optional
         ├── sidecar-parsing   PDF and Office extraction
         └── mcp-sandbox       embedded tools, isolated workspace and browser

• La api sirve la API REST, el Studio y el script del widget. Aparte de exportar su propia telemetría, nunca llama al mundo exterior: todo lo que sale de la plataforma sale desde el worker.
• El worker ejecuta los agentes: llamadas a modelos, búsqueda documental, llamadas a herramientas, correos electrónicos y webhooks. Cada petición saliente pasa por una protección anti-SSRF.
• Si falta un servicio marcado como opcional, solo se degrada la función que aporta y nada más falla.

Ediciones

Edición	Licencia	Qué añade
Community	GNU AGPL-3.0	Todo lo necesario para crear, publicar y operar agentes, para una organización
Enterprise	Rikoo Enterprise License, con una licencia firmada	SSO, aprobación humana, controles de publicación, auditoría completa, conectores de fuentes, varias organizaciones, exportación de trazas por organización

La edición Enterprise es otra compilación de las mismas imágenes, activada por una licencia. Consulte Licencia Enterprise.

Después de la instalación

• Coloque la api detrás de un proxy inverso que haga la terminación TLS y asigne a PUBLIC_URL la dirección que escriben los usuarios.
• Haga copias de seguridad de la base de datos PostgreSQL, del almacenamiento de objetos y de la clave privada de sellado de la bóveda. Guarde esa clave en un lugar distinto de la base de datos que protege: sin ella, una copia de seguridad restaurada no puede leer ningún secreto almacenado.
• Conecte la plataforma a su monitorización: los endpoints de salud, las métricas de Prometheus y las trazas de OpenTelemetry se enumeran en Infraestructura.

Instalación sin conexión

Rikoo funciona sin acceso a internet. El registro de precios y capacidades de los modelos se distribuye con el producto y nunca se descarga en tiempo de ejecución, así que el único tráfico saliente va a los proveedores de modelos que usted configure. Con un servidor de modelos en su propia red, como vLLM u Ollama, no hay ninguno: autorice su rango de direcciones con RIKOO_EGRESS_ALLOW_CIDRS, como se explica en Infraestructura.

Construir las imágenes desde el código fuente descarga dependencias: constrúyalas, u obténgalas, en una máquina con acceso y súbalas a un registro al que lleguen sus servidores.