Bóveda de notas en Markdown, autoalojada y minimalista.
Cogny es una aplicación web de notas al estilo Obsidian construida con Django. Las notas viven como archivos Markdown en disco, organizadas en carpetas, sin depender de una base de datos para el contenido. Incluye editor con resaltado de código, fórmulas, diagramas, adjuntos y exportación a PDF con fidelidad completa.
 Exportar cualquier nota a PDF, en claro u oscuro. |
 Búsqueda instantánea por nombre y contenido. |
 Estadísticas de la bóveda, optimización de imágenes a WebP y backup en ZIP antes de aplicarla. |
|
- Notas en Markdown organizadas en carpetas, guardadas como archivos en disco.
- Editor con resaltado de sintaxis, fórmulas (KaTeX), diagramas (Mermaid) y callouts.
- Exportación de notas a PDF, con imágenes y estilos incrustados.
- Búsqueda instantánea por nombre y por contenido.
- Optimización de imágenes a WebP, al subirlas o en bloque para toda la bóveda, con backup ZIP previo opcional.
- Importación y exportación de la bóveda completa en un único ZIP.
- Progressive Web App instalable, con caché de estáticos para uso offline.
- Backend: Django + gunicorn (WSGI).
- Datos: SQLite para cuentas de usuario; las notas y adjuntos son archivos en disco.
- Frontend: JavaScript nativo, sin framework ni paso de compilación.
- Exportación a PDF: Chromium headless.
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env # completa DJANGO_SECRET_KEY y las rutas de datos
python manage.py migrate
python manage.py runserverdocker compose up --buildLevanta Cogny en http://localhost:8000. Las notas, avatares y la base de datos
se persisten en ./data. Para crear el primer usuario:
docker compose exec web python manage.py createsuperuserscripts/cogny.service es la referencia de la unidad systemd usada en producción (gunicorn detrás de un proxy inverso con TLS). Tras cualquier cambio en los estáticos, ejecuta collectstatic, sube ASSET_VERSION en .env y reinicia el servicio para invalidar la caché.