Vera

Una memoria viva para profundizar y trabajar con inteligencias artificiales sin entregar el control de tu conocimiento.

Vera es una wiki personal, local-first y mantenible por personas y agentes. El proyecto se documenta desde su propio corpus para no sostener versiones paralelas de la misma explicación.

Conocer Vera

• Presentación
• Manual
• Principios y postura ética
• Hoja de ruta
• Arquitectura
• Seguridad
• Probar e instalar

Vera es actualmente una alfa de investigación: funciona sobre un corpus real, pero está destinada por ahora a una persona y un grafo. No es todavía un servicio multiusuario listo para producción.

Warning

La aplicación privada escucha en loopback por omisión. No expongas directamente ese puerto a Internet: las personas aún no se autentican ante Vera. Lee Seguridad y Exponer Vera antes de cambiar la frontera de red.

Instalación

Hay dos caminos, según qué se necesite.

Aplicación de escritorio (Windows, macOS y Linux)

La vía más simple para probar Vera sin tocar código: memoria inicial ya cargada y, donde hay firma comercial, actualización automática por canal estable.

Descargar la última versión desde GitHub Releases. El instalador de Linux (AppImage o deb) es siempre confiable — no requiere firma de código. Los de Windows y macOS hoy se publican sin firmar, marcados "(sin firmar)": conseguir una identidad Authenticode o notarización de Apple no es viable ahora mismo para quien mantiene Vera. El sistema operativo va a advertirlo (SmartScreen o Gatekeeper) antes de dejarte abrirlo; las instrucciones para instalar de todas formas están en Instalación en Windows y en Distribución de Vera Desktop.

Desde el código fuente

Requiere Node.js 24 o posterior.

git clone https://github.com/mediafranca/vera.git
cd vera
npm install
cp .env.example .env          # define VERA_OWNER y VERA_OWNER_NAME
npm run build
npm run serve                 # http://127.0.0.1:4173

Antes de escribir en una instancia propia, sigue la guía de portabilidad: la identidad inicial determina quién firma las operaciones del grafo, y explica por qué conviene hacer un fork antes de clonar. Para desarrollar también hacen falta el validador de Allium y los pasos de CONTRIBUTING.md.

npm run spec
npm run typecheck
npm test

Conectar una IA a tu Vera

Vera no se usa sólo desde su interfaz: cualquier cliente que hable MCP —Claude Code, Claude Desktop, Codex, Gemini CLI, LM Studio y otros— se conecta a la misma puerta y opera el corpus con su propia identidad y credencial. La guía completa, con los cinco valores de conexión y un caso por cada forma de desplegar el cliente, está en Conectar una IA.

Documentación del código

El índice técnico reúne arquitectura de implementación, conexión MCP, portabilidad, exposición, obligaciones de prueba y planes de trabajo. Las especificaciones Allium son la fuente de verdad del comportamiento.

Proyectos relacionados

Vera Conecta es el puente opcional entre una instalación local de Vera y clientes MCP en Internet, sin abrir puertos, IP pública ni Tailscale. Vive en un repositorio propio porque es infraestructura de red con su propio ciclo de despliegue; hoy es un walking skeleton (M0/M1), sin ambiente desplegado.

Vera se publica bajo GNU AGPL-3.0-only. Consulta también LICENCIA.md, AUTHORS.md, CONTRIBUTING.md y NOTICE.

Soberanía digital

Puño alzado: Eugenio Hansen, OFS — trabajo propio, CC BY-SA 4.0, vía Wikimedia Commons.

Vera forma parte de MediaFranca.