https://github.com/luismisanve/langtosql_lite
Android App assisted with an AI that translates natural language to SQLite queries
https://github.com/luismisanve/langtosql_lite
ai android-studio database gemini java sqlite
Last synced: 24 days ago
JSON representation
Android App assisted with an AI that translates natural language to SQLite queries
- Host: GitHub
- URL: https://github.com/luismisanve/langtosql_lite
- Owner: LuisMiSanVe
- License: apache-2.0
- Created: 2025-08-07T06:40:01.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-05-27T15:34:42.000Z (26 days ago)
- Last Synced: 2026-05-27T17:15:13.993Z (26 days ago)
- Topics: ai, android-studio, database, gemini, java, sqlite
- Language: Java
- Homepage:
- Size: 1.32 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.es.md
- License: LICENSE
Awesome Lists containing this project
README
> [Ver en ingles/See in english](https://github.com/LuisMiSanVe/LangToSQL_Lite/tree/main)
# 
LangToSQL Lite | Aplicación Asistida por IA para SQLite
[](https://www.java.com/)
[](https://developer.android.com/studio)
[](https://www.newtonsoft.com/json)
[](https://aistudio.google.com/app/apikey)
[](https://developer.android.com/studio)
>[!NOTE]
> Dale un vistazo a las otras versiones del programa:
>- [WinForms](https://github.com/LuisMiSanVe/LangToSQL/tree/main)
>- [REST API](https://github.com/LuisMiSanVe/LangToSQL_API/tree/main)
>- [ChatBot](https://github.com/LuisMiSanVe/LangToSQL_ChatBot/tree/main)
>- [NuGet](https://github.com/LuisMiSanVe/LangToSQL_NuGet/tree/main)
>- [LLM](https://github.com/LuisMiSanVe/LangToSQL_LLM/tree/main)
Esta App usa la IA de Google 'Gemini 2.0 Flash' para generar consultas a bases de datos SQLite.
La IA convierte lenguaje natural a consultas SQL usando un método con sus ventajas y desventajas.
## 📋 Prerequisitos
Para que el programa funcione, necesiatarás una base de datos SQLite y una clave de la API de Gemini.
## 🛠️ Instalación
Puedes usar o bien una clave de API de Gemini o un servidor local de LLM, para ello recomiendo [LM Studio](https://lmstudio.ai/).
Obten tu clave de la API de Gemini yendo aquí: [Google AI Studio](https://aistudio.google.com/app/apikey). Asegúrate de tener tu sesión de Google abierta, y entonces dale al botón que dice 'Crear clave de API' y sigue los pasos para crear tu proyecto de Google Cloud y conseguir tu clave de API. **Guárdala en algún sitio seguro**.
Google permite el uso gratuito de esta API sin añadir ninguna forma de pago, pero con algunas limitaciones.
En Google AI Studio, puedes monitorizar el uso de la IA haciendo clic en 'Ver datos de uso' en la columna de 'Plan' en la tabla con todos tus proyectos. Recomiendo monitorizarla desde la pestaña de 'Cuota y límites del sistema' y ordenando por 'Porcentaje de uso actual', ya que es donde más información obtienes.
Ya tienes todo lo que necesitas para hacer funcionar el programa.
Simplemente pon los datos que acabas de conseguir en las pantallas de configuración del programa.
## 📖 Sobre la aplicación
**[Método de traducción de Lenguaje Natural a SQL:](https://gist.github.com/LuisMiSanVe/2da8e2d932a06ef408b3ee8468d0d820)**
Este método mapea la estructura de la base de datos en un JSON que la IA analiza ([con este prompt](https://gist.github.com/LuisMiSanVe/b189c8920d2dcedf5fd46485f3403d51)) para crear una consulta SQL, la cual es ejecutada en la base de datos SQLite directamente.
Ya que este método no mapea los valores de la base de datos el uso de tokens es menor, y los datos que devuelve son mas fiables pues es el mismo Servidor el que los devuelve. Sin embargo, no evita completamente los errores que cometa la IA. A veces, la consulta SQL fallará debido a que la IA inventa columnas que no existen, en ese caso deberás comprobar la consulta generada para que identifiques el fallo.
## 🎨 Opciones de Personalización
La app tiene una `pantalla de Ajustes` que permite al usuario configurar la aplicación.
Los ajustes están separados en dos bloques:
- **Ajustes de base de datos**\
Estos ajustes te permiten elegir entre una base de datos SQLite o conectarse a la [API REST de LangToSQL](https://github.com/LuisMiSanVe/LangToSQL_API/tree/main) lo que cambia drásticamente la función de la app, funcionando más como un visualizador de la API REST, ya que el resto de ajustes serán sobreescritos con los de la API. Este modo te permite dejarle el trabajo pesado a un servidor externo y ver los resultados devueltos por la base de datos PostgreSQL del servidor en su lugar.
- **Ajustes de IA**\
Puedes elegir si bien usar la API de Gemini o un servidor local de LLMs.
Tambíen puedes activar los campos de sentencia directa, donde puedes escribir tus propios SELECT y ejecutarlos en la base de datos SQLite.
>[!TIP]
>Si eres un desarrollador y estás usando Android Studio, recuerda que el emulador llega a tu localhost a través de la IP `10.0.2.2`, en un movil normal solo tendrías que poner la IP pública de tu equipo.
## 🚀 Lanzamientos
Una versión será lanzada solo cuando se cumplan los siguientes puntos:\
Nuevas funciones importantes y arreglos de fallos criticos causarán la salida inmediata de una nueva versión, mientras que otros cambios o arreglos menores deberán esperar una semana desde que se incluyeron en el repositorio antes de ser incluidos en la nueva versión, para que otros posibles cambios puedan ser añadidos también.
>[!NOTE]
>Estos posibles nuevos cambios no alargarán la espera de la salida de la nueva versión a más de una semana.
El número de la versión seguirá este formato: \
\[Añadido Importante\].\[Añadido Menor\].\[Arreglos de Errores\]
## 💻 Tecnologías usadas
- Lenguaje de programación: [Java](https://www.java.com/)
- Otros:
- [SQLite](https://sqlite.org/)
- [LM Studio](https://lmstudio.ai/)
- Gemini API Key (2.0 Flash)
- Imagenes (Fuente original de los iconos, luego retocados por mí):
- [FreeIcons](https://freeicons.io/)
- [Depositphotos](https://depositphotos.com/vector/coarse-halftone-dots-pattern-gradient-in-vector-format-82396024.html)
- IDE Recomendado: [Android Studio](https://developer.android.com/studio)