Ir al contenido

Si tienes el servidor, tienes el sistema

Orpyca es software libre bajo licencia AGPL-3.0. Se descarga, se instala y se usa sin pagar nada: sin licencias, sin usuarios contados, sin fecha de caducidad y sin llamar a nadie para pedir permiso.

Esto no es una versión recortada ni una prueba de treinta días. Es el sistema completo, con la inteligencia artificial incluida. La única condición es tener dónde ejecutarlo.

Qué hardware necesitas

Estas cifras corresponden a una institución de menos de cinco mil usuarios. Un archivo con volumen alto de digitalización necesitará más espacio, no más procesador.

Procesador
4 núcleos, arquitectura x86-64 o ARM64
Memoria
16 GB
Disco del sistema
500 GB en estado sólido, para la base de datos
Disco documental
De 1 a 5 TB para el depósito de documentos
Red
100 Mbps
Sistema operativo
Linux con Docker 24 o superior, o Kubernetes

Qué hardware necesita la inteligencia artificial

Aquí conviene separar dos cosas que suelen mezclarse, porque tienen requisitos muy distintos.

Búsqueda por significado y antecedentes con cita

No usan modelo generativo: convierten el texto en vectores y comparan. El modelo que hace esa conversión es pequeño y corre en el procesador, dentro del propio contenedor.

Funciona en el servidor base, sin tarjeta gráfica.

Asistente conversacional y respuestas redactadas

Aquí sí hay un modelo de lenguaje generando texto. Puede correr en el procesador, pero a dos o cuatro palabras por segundo: una respuesta tarda más de un minuto y nadie la espera. Con tarjeta gráfica baja a pocos segundos.

Necesita tarjeta gráfica para ser usable en la práctica.

Memoria de video según lo que quieras correr

ConfiguraciónVRAMModelo que cabeBúsquedaAsistente
Sin tarjeta gráfica Búsqueda por significado y antecedentes con cita funcionan igual. El asistente responde, pero tarda más de un minuto por respuesta. Es una opción legítima si solo quieres la búsqueda.Ninguno generativoInviable en la práctica
Mínimo para asistente Es el punto de entrada real. Cabe el modelo por defecto con espacio para el contexto de una consulta con varios documentos recuperados. Tarjetas de gama media de escritorio ya lo cubren.8 GBllama3.1 de 8B, contexto de 8 mil tokensSí, unos segundos por respuesta
Holgado Permite meter más documentos en cada consulta, que es lo que mejora de verdad la calidad de una respuesta con citas, y atender varias consultas a la vez sin que se hagan cola.16 GBllama3.1 de 8B con contexto de 32 mil tokens, o un modelo de 12B a 14BSí, con contexto amplio
Calidad alta La diferencia se nota en textos con lenguaje normativo, donde un modelo pequeño se equivoca de matiz. Es la configuración que recomendaríamos a una entidad que vaya a apoyarse en el asistente a diario.24 GBModelo de 27B a 32B cuantizadoSí, con mejor redacción jurídica
Institución grande Solo tiene sentido con muchos usuarios usando el asistente al mismo tiempo. Por debajo de eso, el dinero rinde más en disco y respaldos que en memoria de video.48 GB o dos tarjetas de 24 GBModelo de 70B cuantizadoSí, varias consultas simultáneas

La memoria que cuenta es la de la tarjeta (VRAM), no la del sistema. Si el modelo no cabe completo, Ollama reparte capas entre tarjeta y procesador y la velocidad se desploma: es mejor un modelo más pequeño que quepa entero que uno grande a medias.

Ollama no viene incluido en el arranque

El sistema trae la búsqueda semántica lista, pero el servidor de modelos se levanta aparte, como perfil opcional. Es una decisión deliberada: la mayoría de las instalaciones empiezan sin generación y la añaden después.

El modelo por defecto se puede cambiar

El sistema apunta a llama3.1 si no dices otra cosa. Puedes señalar cualquier modelo que sirva Ollama, o un servicio compatible que ya tenga tu entidad. Las cifras de esta tabla se mueven con el modelo que elijas.

Alquilar la tarjeta no es la salida fácil

Puedes apuntar a un proveedor externo y no comprar hardware, pero entonces aplica la frontera de reserva: el material clasificado como reservado no se enviará, y esas consultas caerán en modo de búsqueda. Si tu acervo es mayoritariamente reservado, la tarjeta propia no es un lujo: es la única forma de que la función sirva.

Inteligencia artificial soberana

Lo que necesitas además del servidor

El hardware es la mitad de la respuesta. Esta es la otra mitad, y conviene tenerla antes de empezar.

Obligatorio

Un dominio con tres nombres

El sistema se publica en tres direcciones distintas: la aplicación, la interfaz de programación y el servidor de identidad. Las tres deben resolver por DNS y estar incluidas en el mismo certificado.

Obligatorio

Certificado TLS

Puede ser gratuito con Let’s Encrypt, que exige tener el puerto 80 accesible desde internet, o el de la autoridad de certificación de tu entidad.

Obligatorio

Un proxy inverso propio

El sistema no publica puertos al exterior ni termina el cifrado: delante hace falta un Nginx, Traefik o equivalente que reciba el tráfico y lo reparta. No viene incluido, y es la pieza que más se olvida.

Obligatorio

Un servidor de correo saliente

Es obligatorio, no opcional: sin él el sistema no arranca en producción. Además transporta el código de segundo factor del acto de firma, así que sin correo tampoco hay firma personal.

Obligatorio

Cortafuegos configurado

Solo deben quedar abiertos los puertos 80 y 443, más el de administración remota. La base de datos, el depósito de objetos y la caché no deben ser accesibles desde fuera.

Según lo que uses

Una autoridad de certificación acreditada

Necesaria si vas a firmar con efectos probatorios plenos. La que viene incluida sirve para probar el sistema, no para dar fe: hay que conectar una entidad acreditada ante el ONAC y montar el sello institucional de la entidad.

Según lo que uses

Un buzón de correo para la ingesta

Solo si quieres que los correos que llegan a una dirección institucional se radiquen automáticamente. Sin configurarlo, esa función queda apagada.

Según lo que uses

Credenciales del operador postal

Solo si quieres el seguimiento automático de los envíos físicos. Sin ellas, el módulo de correspondencia funciona con las guías registradas a mano.

Quién debe hacer la instalación

Que sea gratis no significa que sea trivial. Estos son los conocimientos que la documentación exige de quien lo despliegue.

  • Administración de Linux y de contenedores
  • Seguridad de redes: cortafuegos, proxy inverso, certificados
  • Administración de PostgreSQL
  • Respaldos y pruebas de recuperación

Y después, lo que hay que sostener

Respaldos, y no solo de la base de datos

Hay que respaldar la base, el depósito de documentos y —esto se olvida siempre— las claves de firma y de cifrado. Perder la base se recupera del respaldo; perder las claves deja firmas históricas que ya nadie puede verificar. El sistema documenta cómo hacerlo, pero no trae la herramienta montada: la programa tu equipo.

Actualizaciones con intervención manual

Las migraciones de base de datos no se aplican solas: hay que ejecutarlas servicio por servicio al actualizar, y también cada vez que se da de alta una institución nueva. No hay reversión automática, así que se hace con respaldo reciente y ventana acordada.

Vigilancia y reinicio

Conviene revisar los registros y configurar el reinicio automático de los contenedores y las alertas de espacio en disco. Es trabajo de operación normal, pero hay que asignarlo a alguien.

Si tu entidad no tiene ese equipo, o lo tiene y está ocupado en otra cosa, eso es exactamente lo que ofrecemos como servicio. El software sigue siendo gratis: lo que se contrata es que alguien lo monte y responda por él.

Servicios

Lo que tu entidad debe tener antes, en lo archivístico

Esta parte no la resuelve el software ni la resolvemos nosotros. Sin ella el sistema funciona, pero no te sirve para cumplir.

  1. 01

    Tabla de retención documental aprobada

    Con sus series, subseries, plazos en archivo de gestión y central, y disposición final. Debe estar aprobada por el comité evaluador correspondiente: es un acto administrativo, no un archivo de hoja de cálculo.

  2. 02

    Cuadro de clasificación documental

    La estructura jerárquica sobre la que cuelga todo lo demás. Debe corresponder a la estructura orgánica vigente de la entidad.

  3. 03

    Inventario documental

    En el formato único, con las unidades de conservación identificadas. Es el puente entre lo que hay en las cajas y lo que dice el sistema, y es obligatorio para transferencias y disposición.

  4. 04

    Criterios de digitalización definidos

    Si vas a incorporar imágenes de documentos físicos, deben venir con la calidad y el formato que exige la norma, y con su acta por lote. El sistema valida el formato, pero no puede mejorar una imagen mal capturada.

  5. 05

    Estructura de dependencias y responsables

    Quién radica, quién tramita, quién firma, quién custodia. Es la configuración inicial del sistema y conviene decidirla antes, no durante.

Si estos instrumentos no están listos, se puede empezar por ahí: hacemos el diagnóstico y el acompañamiento como parte de la implementación. Pero conviene saber que ese trabajo existe y que es previo.

Cómo se instala

Tres comandos y el sistema queda arriba con todos sus servicios.

  1. 1. Clona el repositorio

    git clone https://gitlab.com/orpyca/orpyca-mcp.git
  2. 2. Copia y ajusta la configuración

    cp infra/.env.example infra/.env
  3. 3. Levanta el sistema

    docker compose up -d

El archivo de configuración de ejemplo está documentado línea por línea. Los valores que traen las plantillas son de desarrollo y deben cambiarse antes de exponer el sistema: la documentación indica cuáles.

Documentación

Y después de instalarlo

Carga tus instrumentos archivísticos

El cuadro de clasificación y la tabla de retención de tu entidad, y la estructura de dependencias. Sin eso el sistema funciona, pero no te sirve.

Conecta una entidad de certificación acreditada

La que trae el sistema es local y sirve para probar, no para dar fe. Si vas a firmar con efectos probatorios plenos, necesitas una entidad acreditada ante el ONAC.

Pide ayuda si la necesitas

Que sea gratis no significa que sea trivial. Poner en marcha un sistema de gestión documental en una entidad pública es un proyecto, no una instalación. Si prefieres que lo hagamos nosotros, para eso están los servicios.

Servicios