Obsidian + Hermes en VPS: conecta tu memoria paso a paso

Una sola memoria en tu Mac, en GitHub y en tu VPS

Ya tienes a Hermes funcionando en tu servidor y tu bóveda de Obsidian en el Mac, pero viven separados y no se hablan. ¿De qué sirve un agente que no duerme si no puede leer ni escribir en tus propias notas? En esta guía conectamos las dos piezas: el mismo Obsidian sincronizado en tu Mac y en tu VPS, con Hermes leyendo y escribiendo en una única base de conocimiento, en los dos sentidos.

Cuando el puente está montado pasa esto: le mandas una idea a Hermes desde el móvil y aparece ordenada en el Obsidian de tu Mac sin tocar nada; le preguntas por un proyecto y te responde leyendo tus propias notas. Vamos a montarlo paso a paso, con los comandos exactos.

Qué vas a conseguir (la arquitectura)

El truco está en usar GitHub como puente entre los dos extremos. Obsidian guarda tus notas en archivos Markdown planos; Git es perfecto para sincronizar archivos de texto. Así que el flujo queda así:

Mac (Obsidian)  ⇄  GitHub (repo privado)  ⇄  VPS (Hermes)

• Tu Mac sube y baja cambios a GitHub automáticamente (plugin de Obsidian).
• Tu VPS sube y baja los mismos cambios a GitHub cada pocos minutos.
• Hermes apunta a esa carpeta del VPS, así que cualquier nota que él cree o modifique acaba en tu Obsidian, y al revés.

Una bóveda, sincronizada en los dos sentidos, accesible desde el Mac, el móvil y el agente. Ahí está el valor: no es instalar Obsidian (eso es trivial), es que ese mismo Obsidian viva también junto a Hermes en el servidor.

Antes de empezar: requisitos

Esto es lo que el vídeo da por hecho y conviene tener claro:

• Un VPS con Hermes ya instalado y funcionando. Si todavía no lo tienes, primero monta Hermes en tu VPS y, idealmente, conéctalo a Telegram (te dejará pedirle cosas por chat).
• Acceso por SSH a ese VPS (el comando con el que entras habitualmente, por ejemplo ssh hermes).
• Git instalado en el VPS. Compruébalo con git --version; si no está, en Debian/Ubuntu: sudo apt update && sudo apt install -y git.
• Obsidian instalado en tu Mac (o Windows/Linux: el proceso es idéntico salvo la terminal).
• Una cuenta de GitHub. Es gratis y el repositorio será privado.
• Soltura básica con la terminal (cd, ls, copiar y pegar comandos).

Trabajaremos con notas privadas, así que todo va en un repositorio privado. Nunca subas tus notas a un repo público.

Cómo funciona el puente (y por qué GitHub)

Podrías usar Obsidian Sync o un Dropbox, pero GitHub te da tres cosas gratis que aquí importan: historial de versiones (puedes recuperar cualquier nota borrada), sincronización fiable de texto y un punto común al que tanto tu Mac como tu VPS pueden conectarse sin abrir puertos en tu servidor. Hermes no necesita acceso directo a tu Mac: ambos hablan con GitHub y se cruzan ahí.

---

Paso 1 — Crea una bóveda nueva en Obsidian

Abre Obsidian y, en la pantalla de gestionar bóvedas, crea una bóveda nueva (no uses una existente para no mezclar conocimiento). En el vídeo la llamamos Hermes.

1. Elige una ubicación que recuerdes (por ejemplo Escritorio/Obsidian/).
2. Apunta la ruta completa de la bóveda: la vas a necesitar durante toda la instalación.
3. Crea una primera nota, por ejemplo inicio.md, con una línea cualquiera (“Bóveda de conocimiento conectada a Hermes”). Sirve para comprobar luego que la sincronización funciona.

Paso 2 — Crea un repositorio privado en GitHub

En GitHub, ve a tus repositorios → New:

• Nombre: Hermes-Obsidian-Vault (puedes usar otro, pero sigue el tutorial con este).
• Visibilidad: Private. Importante: son tus notas.
• No marques “Add a README”, “Add .gitignore” ni “Choose a license” (déjalo todo en None/Off). El repo debe nacer vacío.

Crea el repositorio y copia la URL SSH que te da (git@github.com:TU_USUARIO/Hermes-Obsidian-Vault.git). La usaremos enseguida.

Paso 3 — Sube tu bóveda a GitHub desde la terminal

Abre la terminal (en Mac: ⌘ + Espacio → “Terminal”) y entra en la carpeta de tu bóveda:

cd /ruta/a/tu/boveda/Hermes
pwd            # confirma que estás dentro de la bóveda
git init
git add .
git commit -m "Inicio de la bóveda de Obsidian"
git branch -M main
git remote add origin git@github.com:TU_USUARIO/Hermes-Obsidian-Vault.git
git push -u origin main

Autenticación del Mac con GitHub. Para que el push funcione necesitas que tu Mac esté autenticado. Lo más limpio es usar también una clave SSH en el Mac (el mismo proceso del Paso 5, pero en tu ordenador) y añadirla a GitHub. Como alternativa puedes usar HTTPS con un Personal Access Token. Si ya tienes GitHub configurado en tu Mac, el push irá directo.

Refresca el repositorio en GitHub: deberías ver tu carpeta con la nota de inicio. El volcado manual ya está hecho; ahora vamos a automatizarlo.

Paso 4 — Automatiza la sincronización con el plugin Obsidian Git

Para no hacer commits a mano, instalamos un plugin oficial de la comunidad:

1. En Obsidian: Ajustes → Complementos de la comunidad → Activar.
2. Buscar → escribe git e instala Obsidian Git (el de Vinzent, no otro). Actívalo.
3. Entra en sus opciones y ajusta solo lo necesario:
   • Auto commit-and-sync interval: 10 (minutos). En 0 está apagado.
   • Auto pull interval: 5 (minutos).
   • Pull on startup: activado (al abrir Obsidian, se trae los cambios).
   • Push on commit-and-sync: activado.
   • Pull updates on every commit-and-sync: activado.

A partir de aquí, cada 10 minutos Obsidian hace commit + push de tus cambios, y cada 5 se trae lo nuevo de GitHub. Para forzarlo al instante: abre la paleta de comandos (⌘/Ctrl + P) → Obsidian Git: Commit-and-sync. Crea una nota de prueba, lánzalo y verifica que aparece en GitHub.

Paso 5 — Conecta tu VPS (Hermes) con GitHub por SSH

Ahora el otro extremo. Entra por SSH a tu VPS y comprueba que todavía no hay conexión con GitHub:

ssh -T git@github.com    # → Permission denied (esperado: aún no hay clave)

Genera una clave SSH en el VPS y añádela a GitHub:

ssh-keygen -t ed25519 -C "hermes-vps"
# Pulsa Enter para la ruta por defecto (~/.ssh/id_ed25519)
# Pulsa Enter dos veces para dejar la passphrase vacía
cat ~/.ssh/id_ed25519.pub    # copia TODA la línea que empieza por ssh-ed25519

En GitHub → Settings → SSH and GPG keys → New SSH key: ponle un título (Hermes VPS), pega la clave pública y guarda. GitHub te pedirá verificarlo por email. Comprueba que funciona:

ssh -T git@github.com
# → Hi TU_USUARIO! You've successfully authenticated...

Si el Paso 3 te falló en el Mac, es exactamente esto lo que te faltaba: repite este paso en la terminal de tu ordenador y añade también esa clave a GitHub.

Paso 6 — Clona la bóveda en el VPS

Con la conexión SSH ya autorizada, clona el repositorio en el servidor:

cd /root
git clone git@github.com:TU_USUARIO/Hermes-Obsidian-Vault.git obsidian-hermes-vault
cd obsidian-hermes-vault
ls          # debes ver tu carpeta Hermes con las notas (inicio.md, etc.)

Ya tienes una copia de tu bóveda viviendo dentro del VPS y conectada a GitHub.

Paso 7 — Dile a Hermes dónde está la bóveda

Hermes necesita saber en qué carpeta están las notas. Eso se hace con una variable de entorno que apunta a la bóveda dentro del repo:

export OBSIDIAN_VAULT_PATH=/root/obsidian-hermes-vault/Hermes

Para que persista entre reinicios, añádela al fichero de entorno de tu instalación de Hermes (por ejemplo su .env o el archivo de servicio) en lugar de solo exportarla en la sesión. Después reinicia el gateway de Hermes con el comando de tu instalación (algo como systemctl restart hermes-gateway) para que la lea.

Paso 8 — Deja que Hermes termine la instalación (lo más cómodo)

A partir de aquí podrías terminar a mano (ver el bloque siguiente), pero lo más rápido es delegárselo a Hermes:

1. Selecciona en la terminal todo lo que has ejecutado en el VPS y cópialo.
2. Ve a Hermes en Telegram y pégaselo con un mensaje tipo: “Voy por esta parte del tutorial. ¿Hay algo que puedas terminar tú desde aquí?”.
3. Hermes detecta el contexto y completa lo que falta: confirma que el repo está clonado, que la variable apunta bien, que lee las notas del baúl, crea un script de sincronización y activa la sincronización automática cada 5 minutos en ambos sentidos (VPS → GitHub y GitHub → VPS).

Pídele que te confirme el estado. Debería responderte que puede leer y escribir en la bóveda y que la sincronización está activa.

Alternativa manual: un cron de sincronización

Si prefieres no depender del agente para esta parte, crea tú el script y el cron. Un sync.sh mínimo dentro del repo:

#!/usr/bin/env bash
cd /root/obsidian-hermes-vault || exit 1
git add -A
git commit -m "sync VPS $(date +%F_%T)" --quiet || true
git pull --rebase --autostash origin main
git push origin main

Dale permisos y prográmalo cada 5 minutos:

chmod +x /root/obsidian-hermes-vault/sync.sh
crontab -e
# añade esta línea:
*/5 * * * * /root/obsidian-hermes-vault/sync.sh >> /var/log/obsidian-sync.log 2>&1

Con esto el VPS sube y baja cambios solo, sin intervención de Hermes.

Paso 9 — La prueba real (en los dos sentidos)

De Hermes a tu Mac: pídele a Hermes que cree una nota y haga commit, por ejemplo: “Crea una nota titulada ‘prueba’ con el texto ‘puente Mac–GitHub–VPS correcto’ y haz commit y push.” En segundos la nota aparece en GitHub. En tu Mac, cierra y vuelve a abrir Obsidian (con pull on startup activado se trae el cambio) o espera al intervalo: verás la nota nueva.

De tu Mac a Hermes: crea una nota en Obsidian y, al cabo de unos minutos (o forzando commit-and-sync), pregúntale a Hermes por su contenido. Te responderá leyéndola desde el VPS.

Si las dos pruebas funcionan, el puente está completo.

Resolución de conflictos y buenas prácticas

El vídeo no entra aquí, pero es lo que te ahorrará disgustos cuando lo uses a diario:

• Conflictos de Git. Si editas en el Mac y Hermes edita la misma nota casi a la vez, puede haber conflicto. El git pull --rebase --autostash del script reduce el riesgo; aun así, evita editar la misma nota a la vez en ambos lados. Obsidian Git también avisa de conflictos para resolverlos a mano.
• Ignora la carpeta de configuración. Añade un .gitignore con .obsidian/workspace.json (y, si quieres, toda la carpeta .obsidian/) para no sincronizar el estado de la interfaz entre máquinas.
• La passphrase de la clave SSH. Dejarla vacía es cómodo para automatizar, pero si tu VPS es compartido o expuesto, considera protegerla y usar ssh-agent.
• Backups. El historial de GitHub ya es un backup, pero para notas críticas no está de más una copia adicional.

Solución de problemas frecuentes

• Permission denied (publickey) en el VPS: no añadiste la clave pública a GitHub o el ssh -T git@github.com no devuelve tu usuario. Revisa el Paso 5.
• Updates were rejected al hacer push: alguien (tú o Hermes) subió antes. Haz git pull --rebase y vuelve a empujar.
• Hermes no ve las notas: la variable OBSIDIAN_VAULT_PATH apunta a la carpeta equivocada o no reiniciaste el gateway. Verifica la ruta con ls $OBSIDIAN_VAULT_PATH.
• No llega nada al Mac: comprueba que Obsidian Git tiene pull on startup y un intervalo de pull activos, o fuerza Obsidian Git: Pull.

Obsidian en el móvil

Como todo viaja por GitHub, puedes instalar Obsidian en el móvil, abrir la misma bóveda con el plugin Obsidian Git apuntando al mismo repo privado, y tendrás tus notas (y las que escriba Hermes) también en el teléfono. Mandas una idea desde el móvil y termina ordenada en el Mac y disponible para el agente.

Conclusión

Has montado un puente completo: Obsidian (Mac y móvil) ⇄ GitHub privado ⇄ Hermes en el VPS, sincronizado en ambos sentidos cada pocos minutos. A partir de ahora tu agente no solo “no duerme”: comparte tu memoria. Puede consultar tus proyectos leyendo tus propias notas y dejar por escrito lo que genere, en la misma bóveda que tú usas cada día.

En ExpertBrain montamos este tipo de infraestructura de agentes para empresas y organismos en producción. Si quieres llevar tu agente al siguiente nivel, hablemos.