Docs
De cero a una memoria consultable que tu asistente puede leer.
Acceso anticipado. Estos pasos describen la compilación de escritorio para Windows y la réplica alojada. Ambas cambian cada semana; si algo aquí no coincide con lo que ves, la aplicación tiene razón y esta página está desactualizada — dínoslo en hello@varven.net.
1. Instalación
Descarga el instalador de Windows y ejecútalo. En el primer arranque Varven pide dos cosas:
- Una carpeta para la bóveda. Cualquier carpeta. Si ya guardas notas en Markdown, apúntala ahí — Varven lee lo que ya está presente.
- Permiso para ejecutar un modelo local. La organización ocurre en tu propio hardware, y nada de ella requiere la nube.
Varven usa tu GPU automáticamente cuando la tienes y recurre a la CPU cuando no: más lento, pero funciona y no fallará en silencio.
2. Revisa tu bóveda
Antes de la primera sincronización, Varven inspecciona tu bóveda y reporta lo que no se trasladaría limpiamente — duplicados, notas que no puede clasificar, entradas demasiado largas para indexarse completas. La comprobación se ejecuta en local y no envía nada.
3. Conecta un cliente de IA
Varven habla el Model Context Protocol sobre Streamable HTTP, así que funciona cualquier cliente MCP. En Claude: Configuración → Conectores → Añadir conector personalizado, luego pega:
https://api.varven.net/mcpClaude te enviará a una página de inicio de sesión. Aprueba, y el conector aparecerá en tu lista de herramientas. La misma URL funciona en cualquier cliente que admita conectores MCP remotos — entre ellos ChatGPT, Gemini, Cursor y VS Code, en la medida en que su propio soporte de conectores lo permita. Consulta los ajustes de conectores de cada cliente.
4. Lo que puede hacer tu asistente
| Herramienta | Qué hace |
|---|---|
memory_search | Búsqueda híbrida por palabras clave y semántica en toda tu bóveda |
memory_get | Obtiene una memoria completa por id |
memory_briefing | Contexto permanente: elementos fijados, preferencias, correcciones |
memory_timeline | Qué cambió recientemente, en orden |
Los cuatro son de solo lectura en la versión actual. La escritura desde la nube está en la hoja de ruta.
Cómo leer un resultado
Los resultados llevan marcas a las que conviene prestar atención:
- stale — nadie ha vuelto a comprobar esta afirmación recientemente. Los distintos tipos de memoria envejecen a distinta velocidad, y la marca lo refleja. Las preferencias y correcciones nunca caducan, porque son ciertas por el hecho de haberse dicho.
- weak_match — incluso la mejor coincidencia puntuó mal. Probablemente no sea tu respuesta, y tu asistente debería decirlo en lugar de escribir prosa segura a su alrededor.
- superseded — esto fue reemplazado por algo más reciente. La versión antigua sigue siendo consultable, que es lo que te permite preguntar cuándo cambió algo en lugar de reescribir el historial en silencio.
Cuando algo parece ir mal
La búsqueda no devuelve nada, pero la bóveda tiene notas
Normalmente la primera sincronización no ha terminado. Revisa el panel de sincronización. Si dice
que está completa, ejecuta --inspect — una bóveda sin frontmatter reconocido se sincroniza
sin problemas y busca mal.
La primera pregunta tras una pausa es lenta
El modelo local se descarga cuando está inactivo y tarda unos 30 segundos en volver a cargarse en la VRAM. Eso no es un cuelgue. Solo afecta a las operaciones locales; la réplica en la nube responde al instante.
El conector no autoriza
Casi siempre es una URL que no coincide. La dirección debe ser exactamente
https://api.varven.net/mcp — sin barra final, sin http://.
Los identificadores de recurso de OAuth se comparan literalmente y una discrepancia falla con un
mensaje poco útil.
Las respuestas empeoraron y no hubo ningún error
Probablemente el modelo local no esté accesible, y la búsqueda ha degradado en silencio a solo palabras clave. El panel de estado muestra la salud del modelo. Este fallo es silencioso por naturaleza, y por eso existe el indicador.