Cogny 🧠

Tu Base de Conocimiento Inteligente y Gestor de Notas.

Cogny es una potente aplicación para la toma de notas jerárquicas diseñada para desarrolladores y usuarios avanzados. Construida con Python y PySide6, ofrece una experiencia fluida para organizar información compleja, fragmentos de código y documentación.

📸 Capturas de Pantalla

Interfaz Principal

Gestiona tu conocimiento con un diseño limpio de doble panel. El árbol jerárquico te permite estructurar notas profundamente anidadas, mientras que el editor soporta un formato Markdown enriquecido.

Estadísticas e Insights

Visualiza tus hábitos de escritura y el crecimiento de tu base de datos.

Bóveda Segura

Mantén protegida tu información sensible.

---

✨ Características Clave

• Organización Jerárquica: Crea carpetas y notas anidadas ilimitadas. Arrastra y suelta para reorganizar sin esfuerzo.
• Protección Estricta de Estructura:
  • Evita el anidamiento accidental en notas finales (lógica de rebote).
  • Las carpetas actúan como contenedores (solo lectura) para mantener la estructura limpia.
• Editor Markdown Enriquecido:
  • Resaltado de sintaxis para bloques de código (Python, SQL, Bash, etc.).
  • Código en Línea: Texto entre comillas ( texto ) se muestra con énfasis.
  • Auto-formato (listas, encabezados).
  • Copia de Código: Botones de copia con un clic para fragmentos de código.
• Zoom Centrado en el Usuario:
  • Zoom de Texto: Ajusta el tamaño de fuente independientemente (Ctrl + / -).
  • Zoom de Imagen: Escala imágenes independientemente (Ctrl + Shift + / -).
  • Sin zoom accidental con Ctrl+Rueda.
• UI Moderna: Soporte para temas claro/oscuro (personalizable).

🚀 Instalación

📦 Método Recomendado: APT Repository

Para distribuciones basadas en Debian (Ubuntu, Linux Mint, Debian, etc.), puedes instalar Cogny desde nuestro repositorio oficial:

# 1. Descarga la clave y sobreescribe si ya existe sin preguntar
curl -fsSL https://maalfer.github.io/cogny/cogny.gpg.key | sudo gpg --dearmor --yes -o /usr/share/keyrings/cogny-archive-keyring.gpg

# 2. Añade el repositorio (esto es instantáneo)
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/cogny-archive-keyring.gpg] https://maalfer.github.io/cogny stable main" | sudo tee /etc/apt/sources.list.d/cogny.list > /dev/null

# 3. Actualiza e instala automáticamente con -y
sudo apt update && sudo apt install cogny -y

Actualizar a nuevas versiones:

sudo apt update && sudo apt upgrade cogny

🪟 Instalación en Windows

Puedes descargar el instalador ejecutable (.exe) directamente desde la sección de Releases:

1. Ve a Releases.
2. Descarga el archivo Cogny_Setup.exe de la última versión.
3. Ejecuta el instalador y sigue las instrucciones.

📥 Instalación Manual (.deb)

También puedes descargar e instalar el paquete .deb directamente:

1. Descarga el archivo desde Releases
2. Instálalo con:

sudo dpkg -i cogny_*.deb
sudo apt-get install -f  # Si hay dependencias faltantes

🐧 Ejecución desde Código Fuente (Desarrollo)

Sigue estos pasos para configurar y ejecutar la aplicación correctamente:

1. Crear entorno virtual: Genera un entorno aislado para las dependencias del proyecto.

   python3 -m venv venv

2. Activar entorno virtual: Es crucial activar el entorno antes de instalar nada.

   source venv/bin/activate

3. Instalar dependencias: Instala las librerías necesarias (PySide6, etc.).

   pip install -r requirements.txt

4. Lanzar la aplicación: Una vez configurado, ejecuta el archivo principal.

   python3 main.py

🛠️ Configuración

• Base de Datos: Las notas se almacenan en notes.cdb (SQLite).
• Assets: Las imágenes y adjuntos se gestionan internamente.

📈 Historial de Estrellas

---

Creado por El Pingüino de Mario.