🐋 DeepRoot - Interfaz gráfica para interacción con modelos avanzados de IA (LLMs)

Aplicación de escritorio para interactuar con modelos de IA como DeepSeek y Otros Actualización constante de modelos compatibles vía API

Ballena de DeepRoot - Símbolo de raíces profundas

---

📹 Videos Relacionados

1. Demo de Instalación:
   

2. Ponencias FLISoL 2025:
   

3. Entrevistas 2025:
   

---

📌 Tabla de Contenidos

1. Filosofía
2. Características
3. Instalación
   • Guía del Instalador de DeepRoot
   • Resolución de la Dependencia libmpv.so.1
4. Interfaz
5. Uso Avanzado
6. Reportar Problemas
7. Contribuir
8. Licencia

---

🌍 Filosofía

DeepRoot - Herramienta venezolana que democratiza el acceso a IA avanzada mediante software libre. Inspirada en principios de soberanía tecnológica y desarrollo comunitario.

¿Qué hace diferente a DeepRoot?

1. Enfoque de empoderamiento comunitario:

   • No solo es un cliente de IA, es una herramienta para la apropiación social del conocimiento tecnológico.
   • Diseñada específicamente para integrarse con Canaima GNU/Linux, distribución Venezolana (compatible con cualquier distribución GNU/Linux).

2. Modelo de desarrollo alternativo:

   • Prioriza modelos con licencias libres/open-source.
   • Permite control completo sobre los parámetros de los modelos (en desarrollo).

3. Ventajas estratégicas:

   • Facilita la experimentación con ingeniería de prompts (en desarrollo).
   • Ideal para investigación y desarrollo de capacidades locales en IA.

Descripción en otros idiomas:

• English: Venezuelan-developed GUI for API access to LLMs with focus on technological sovereignty.
• Chino (Simplified): 委内瑞拉开发的LLM API图形界面，专注于技术主权。(Wěinèiruìlā kāifā de LLM API túxíng jièmiàn, zhuānzhù yú jìshù zhǔquán.)
• Ruso: Венесуэльский графический интерфейс для доступа к LLM через API с акцентом на технологический суверенитет. (Venesuel'skiy graficheskiy interfeys dlya dostupa k LLM cherez API s aktsentom na tekhnologicheskiy suverenitet.)

---

🚀 Características

🔍 Multi-Modelos

• Soporte para deepseek-chat, deepseek-coder, deepseek-reasoner y gemini-2.0-flash (pronto habrán más).
• Configuración de parámetros (tokens, temperatura (pronto serán incorporados más)).
• Acceso completo a la potencia del modelo vía API (no limitado como chatbots comerciales).

🎨 Personalización

• Temas claros/oscuros
• Resaltado de sintaxis
• Adaptable a diferentes contextos institucionales (universidades, comunidades, planteles educativos, organismos gubernamentales, empresas privadas, entre otros).

📤 Exportación

• Conversaciones en Markdown/HTML
• Ideal para documentar procesos de investigación

💡 Características únicas

• Desarrollo nacional: Creado por y para la realidad venezolana.
• Formación: Herramienta pedagógica para aprender IA.
• Soberanía: Alternativa real a plataformas que promueven dependencia.

---

🖼️ Interfaz Gráfica

Interfaz principal con áreas de chat y controles - Diseñada para usabilidad en entornos educativos

Ingreso de credenciales API - Compatible con múltiples proveedores

Ajustes avanzados de modelos - Control sobre los parámetros

---

📥 Instalación

Requisitos

• Python 3.8+
• Git (opcional)
• Canaima GNU/Linux (recomendado) o cualquier distro Linux

1. Método Automático

curl -sSL https://raw.githubusercontent.com/jonasreyes/deeproot/main/scripts/deeproot_install.sh | bash

2. Manual

git clone https://github.com/jonasreyes/deeproot.git
cd deeproot
./scripts/deeproot_install.sh

Guía del Instalador de DeepRoot

Para una guía detallada sobre el proceso de instalación, consulta la Guía del Instalador de DeepRoot. Esta guía te proporcionará información paso a paso sobre cómo instalar DeepRoot y solucionar problemas comunes.

Resolución de la Dependencia libmpv.so.1

DeepRoot requiere la librería libmpv.so.1 para algunas funcionalidades. Si el instalador no la encuentra, sigue estos pasos:

1. Intenta instalar el paquete libmpv1 (o el equivalente) usando el gestor de paquetes de tu distribución:

   • Canaima/Debian/Ubuntu:

     sudo apt update && sudo apt install libmpv1

   • Arch Linux/Manjaro:

     sudo pacman -S mpv

   • Fedora/RHEL/CentOS:

     sudo dnf install mpv-libs

   • openSUSE/SLES:

     sudo zypper install libmpv1

2. Si ya tienes instalada una versión diferente de libmpv (ej: libmpv.so.2), crea un enlace simbólico:

   sudo ln -s /usr/lib/x86_64-linux-gnu/libmpv.so.2 /usr/lib/x86_64-linux-gnu/libmpv.so.1
   sudo ldconfig

---

🔧 Uso Avanzado

Configuración Inicial de API

1. Acceso API:

   • Abre la pestaña Acceso API
   • Ingresa tu key_api

2. Base URL:

   • DeepSeek: https://api.deepseek.com
   • Gemini: https://generativelanguage.googleapis.com/v1beta/openai/

3. Selección de Modelo:

   • Elige modelo compatible con tu API key y Base URL
   • Recomendado: DeepSeek por su política de acceso más abierta

4. Guardar:

   • Presiona Guardar para aplicar cambios

Consejos para investigación:

• Usa DeepSeek-Coder para desarrollo de software.
• DeepSeek-Reasoner para análisis complejos (la implementación de este modelo está en desarrollo pero ya puedes realizar consultas con él).
• Exporta tus conversaciones para documentar hallazgos.

---

🗑️ Desinstalación

curl -sSL https://raw.githubusercontent.com/jonasreyes/deeproot/main/scripts/deeproot_uninstall.sh | bash

---

🐞 Reportar Problemas

1. Describe el problema
2. Pasos para reproducirlo
3. Captura de pantalla (opcional)

Opciones:

• Abrir Issue en GitHub
• Formulario de Telegram

---

🤝 Contribuir

1. Haz fork del repositorio
2. Crea una rama: git checkout -b mi-mejora
3. Envía Pull Request

¿Primera vez contribuyendo? Guía básica

Áreas prioritarias para contribuciones:

• Traducciones
• Documentación
• Pruebas en diferentes distribuciones
• Desarrollo de nuevas funcionalidades

---

📜 Licencia

Licencia DeepRoot (GPL-compatible)

---

🔗 Enlaces

• Canal Oficial
• Desarrollador
• Repositorio
• Sumarse a la Iniciativa Patria y Software Libre

"DeepRoot es más que software, es un proyecto de soberanía tecnológica"
¡Gracias por usar DeepRoot y ser parte de este movimiento!