Analizador de Texto con IA

Una aplicación de consola que funciona en segundo plano y utiliza inteligencia artificial (Gemini o OpenAI) para analizar texto seleccionado usando atajos de teclado globales.

Características

• ⌨️ Atajos de teclado globales - Funciona en cualquier aplicación
• 📝 Captura de texto seleccionado automáticamente
• 🤖 Análisis con IA usando Gemini o OpenAI
• 📋 Copia de respuestas con atajo personalizado
• 🔄 Intercambio entre APIs (Gemini/OpenAI) en tiempo real
• 🚀 Sin interfaz gráfica - Funciona en segundo plano
• 📊 Sistema de logs para seguimiento de actividad

Requisitos

• Python 3.7 o superior
• Conexión a internet
• API key de Gemini o OpenAI

Instalación

1. Clona o descarga el proyecto

   git clone <tu-repositorio>
   cd GPT-API

2. Instala las dependencias

   pip install -r requirements.txt

3. Configura las API keys

   • Copia el archivo de ejemplo:

     copy config.env.example .env

   • Edita el archivo .env y agrega tus API keys:

     GEMINI_API_KEY=tu_api_key_de_gemini_aqui
     OPENAI_API_KEY=tu_api_key_de_openai_aqui
     DEFAULT_API=gemini
     

Obtener API Keys

Gemini API

1. Ve a Google AI Studio
2. Crea una nueva API key
3. Copia la key y pégala en tu archivo .env

OpenAI API

1. Ve a OpenAI Platform
2. Crea una nueva API key
3. Copia la key y pégala en tu archivo .env

Uso

1. Instala las dependencias actualizadas

   pip install -r requirements.txt

2. Prueba los atajos de teclado (opcional)

   python test_hotkeys.py

3. Ejecuta la aplicación como administrador

   # Opción 1: Versión mejorada (recomendada)
   python text_analyzer_v2.py
   
   # Opción 2: Usar el archivo batch (Windows)
   run_v2.bat
   
   # Opción 3: Versión original (si la v2 no funciona)
   python text_analyzer.py

4. Selecciona texto en cualquier aplicación

   • Abre cualquier aplicación (navegador, editor, etc.)
   • Selecciona el texto que quieres analizar

5. Analiza con IA

   • Presiona Ctrl+F1 para analizar el texto seleccionado
   • La aplicación enviará el texto a la IA configurada
   • Recibirás una notificación cuando esté listo

6. Escribe la respuesta

   • Haz clic en el campo de texto donde quieres la respuesta
   • Presiona Ctrl+F2 para escribir automáticamente
   • La respuesta se escribirá carácter por carácter como si fuera una persona

Atajos de Teclado

Atajo	Función
Ctrl+F1	Analizar texto seleccionado
Ctrl+F2	Escribir respuesta en campo activo
Ctrl+F3	Cambiar entre Gemini/OpenAI
Ctrl+F4	Salir de la aplicación

Estructura del Proyecto

GPT-API/
├── text_analyzer_v2.py   # Aplicación principal mejorada (recomendada)
├── text_analyzer.py      # Aplicación original (consola)
├── screen_analyzer.py    # Aplicación con interfaz gráfica (opcional)
├── test_hotkeys.py       # Script para probar atajos de teclado
├── requirements.txt      # Dependencias de Python
├── config.env.example   # Ejemplo de configuración
├── .env                 # Configuración real (crear manualmente)
├── run_v2.bat          # Script mejorado para ejecutar en Windows
├── run.bat             # Script original para ejecutar en Windows
├── text_analyzer.log   # Archivo de logs (se crea automáticamente)
└── README.md           # Este archivo

Características Técnicas

• Atajos globales: Utiliza pynput (v2) o keyboard (v1) para capturar atajos en cualquier aplicación
• Captura de texto: pyautogui para simular Ctrl+C y obtener texto seleccionado
• Portapapeles: pyperclip para manejar el portapapeles del sistema
• APIs de IA:
  • Gemini: Google Generative AI (gratuito con límites)
  • OpenAI: GPT-3.5-turbo (requiere créditos)
• Logging: Sistema de logs automático en text_analyzer.log
• Configuración: Variables de entorno con python-dotenv

Solución de Problemas

Error: "API key no configurada"

• Verifica que el archivo .env existe y contiene las API keys correctas
• Asegúrate de que no hay espacios extra en las keys

Error: "Permisos de administrador requeridos"

• La aplicación necesita permisos de administrador para los atajos globales
• Ejecuta como administrador: Click derecho → "Ejecutar como administrador"
• En Windows, usa el archivo run_v2.bat que solicita permisos automáticamente
• Si la v2 no funciona, prueba la v1 original con run.bat

Error: "Los atajos no funcionan"

• Prueba primero con python test_hotkeys.py para verificar que los atajos se detectan
• Si el test funciona, el problema puede ser con la captura de texto
• Asegúrate de que hay texto seleccionado antes de presionar Ctrl+Shift+A
• Algunos antivirus pueden bloquear la captura de teclado

Error de conexión a la API

• Verifica tu conexión a internet
• Confirma que las API keys son válidas y tienen créditos disponibles

Limitaciones

• Permisos: Requiere ejecutar como administrador para atajos globales
• Gemini: Gratuito con límites de uso diario
• OpenAI: Requiere créditos pagos para GPT-3.5-turbo
• Texto: Solo funciona con texto seleccionable (no imágenes)
• Sistema: Optimizado para Windows, puede requerir ajustes en otros SO

Contribuciones

¡Las contribuciones son bienvenidas! Por favor:

1. Fork el proyecto
2. Crea una rama para tu feature
3. Commit tus cambios
4. Push a la rama
5. Abre un Pull Request

Licencia

Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

Soporte

Si tienes problemas o preguntas:

1. Revisa la sección de solución de problemas
2. Busca en los issues existentes
3. Crea un nuevo issue con detalles del problema

Ejemplos de Uso

Análisis de Texto

1. Selecciona cualquier texto en tu navegador, editor o aplicación
2. Presiona Ctrl+F1 para analizar
3. Espera la respuesta de la IA
4. Haz clic en el campo de texto donde quieres la respuesta
5. Presiona Ctrl+F2 para escribir automáticamente

Cambio de API

• Presiona Ctrl+F3 para alternar entre Gemini y OpenAI
• Recibe notificación del cambio de API

Salir de la Aplicación

• Presiona Ctrl+F4 para cerrar la aplicación

---

¡Disfruta analizando texto con IA desde cualquier aplicación! 🚀