Versión 1.0

requirements.txt

@@ -1,29 +1,143 @@
-# Dependencias principales
-annotated-doc==0.0.4
-annotated-types==0.7.0
-anyio==4.11.0
-fastapi[standard]==0.121.3
-idna==3.11
-pydantic==2.12.4
-pydantic_core==2.41.5
-sniffio==1.3.1
-starlette==0.50.0
-typing-inspection==0.4.2
-typing_extensions==4.15.0
-uvicorn[standard]
-python-multipart
-python-dotenv
+# ==========================================
+# Web & API Framework (FastAPI)
+# ==========================================
+fastapi==0.121.3            # Framework principal para crear la API
+fastapi-cli==0.0.24         # Interfaz de línea de comandos para FastAPI
+fastapi-cloud-cli==0.15.0   # Herramientas de despliegue para FastAPI
+starlette==0.50.0           # Toolkit ASGI base de FastAPI
+uvicorn==0.41.0             # Servidor ASGI para ejecutar la aplicación
+uvloop==0.22.1              # Ciclo de eventos rápido para Uvicorn
+anyio==4.11.0               # Soporte asíncrono para concurrencia
+sniffio==1.3.1              # Detección de la librería asíncrona en uso
+websockets==16.0            # Soporte para conexiones WebSockets
+watchfiles==1.1.1           # Recarga automática del servidor al detectar cambios
+python-multipart==0.0.22    # Manejo de datos de formularios y subida de archivos
 
-# Procesamiento de audio
-noisereduce
-librosa
-soundfile
-praat-parselmouth
-numpy
+# ==========================================
+# Validación de Datos & Tipado
+# ==========================================
+pydantic==2.12.4            # Validación de datos y gestión de esquemas
+pydantic_core==2.41.5       # Núcleo en Rust para Pydantic (rendimiento)
+pydantic-extra-types==2.11.0 # Tipos adicionales para Pydantic
+pydantic-settings==2.13.1   # Manejo avanzado de variables de entorno
+annotated-types==0.7.0      # Metadatos para el tipado de variables
+typing_extensions==4.15.0   # Funciones de tipado para versiones antiguas de Python
+typing-inspection==0.4.2    # Inspección de tipos en tiempo de ejecución
+email-validator==2.3.0      # Validación de correos electrónicos
 
-# Modelos de IA e integraciones
-openai
-langchain
-langchain-openai
-assemblyai
-anthropic
+# ==========================================
+# Modelos de IA, LLMs & Agentes (LangChain)
+# ==========================================
+openai==2.28.0              # Cliente oficial para la API de OpenAI
+langchain==1.2.12           # Framework para aplicaciones con LLMs
+langchain-core==1.2.19      # Componentes y abstracciones base de LangChain
+langchain-openai==1.1.11    # Integración específica de OpenAI para LangChain
+langgraph==1.1.2            # Creación de agentes y flujos cíclicos con LLMs
+langgraph-checkpoint==4.0.1 # Gestión de estados y memoria para LangGraph
+langgraph-prebuilt==1.0.8   # Componentes preconstruidos para LangGraph
+langgraph-sdk==0.3.11       # SDK oficial de LangGraph
+langsmith==0.7.17           # Monitoreo, trazas y depuración para LangChain
+tiktoken==0.12.0            # Tokenizador rápido usado por OpenAI
+
+# ==========================================
+# Procesamiento de Audio & Voz (Speech-to-Text)
+# ==========================================
+assemblyai==0.56.0          # SDK de AssemblyAI para transcripción de audio
+deepgram-sdk==6.0.1         # SDK de Deepgram para transcripción de audio
+librosa==0.11.0             # Análisis de música y señales de audio
+noisereduce==3.0.3          # Algoritmos para reducción de ruido en audio
+praat-parselmouth==0.4.7    # Interfaz de Python para Praat (análisis fonético)
+soundfile==0.13.1           # Lectura y escritura de archivos de audio
+audioread==3.1.0            # Decodificación de audio multiplataforma
+soxr==1.0.0                 # Conversión de frecuencia de muestreo (resampling) de alta calidad
+
+# ==========================================
+# Ciencia de Datos, Matemáticas & Machine Learning
+# ==========================================
+numpy==2.4.3                # Computación numérica y manejo de arreglos (matrices)
+scipy==1.17.1               # Funciones matemáticas, científicas y de ingeniería
+scikit-learn==1.8.0         # Herramientas de Machine Learning y análisis de datos
+numba==0.64.0               # Compilador JIT (Just-In-Time) para acelerar código matemático
+llvmlite==0.46.0            # Motor subyacente para compilar con Numba
+joblib==1.5.3               # Procesamiento en paralelo y caché (usado por scikit-learn)
+threadpoolctl==3.6.0        # Control de hilos en librerías nativas (C/C++)
+
+# ==========================================
+# Redes & Clientes HTTP
+# ==========================================
+requests==2.32.5            # Cliente HTTP síncrono estándar
+requests-toolbelt==1.0.0    # Utilidades adicionales para la librería requests
+httpx==0.28.1               # Cliente HTTP asíncrono (alternativa moderna a requests)
+httpcore==1.0.9             # Motor subyacente de red para HTTPX
+httptools==0.7.1            # Analizador (parser) de peticiones HTTP ultrarrápido
+h11==0.16.0                 # Implementación pura de HTTP/1.1
+urllib3==2.6.3              # Cliente HTTP base con gestión de conexiones y reintentos
+certifi==2026.2.25          # Colección de certificados SSL/TLS raíz
+idna==3.11                  # Soporte para nombres de dominio internacionalizados
+dnspython==2.8.0            # Herramientas para consultas y manipulación de DNS
+
+# ==========================================
+# Gráficos & Visualización
+# ==========================================
+matplotlib==3.10.8          # Creación de gráficas y visualizaciones de datos
+contourpy==1.3.3            # Cálculo de contornos 2D (dependencia de matplotlib)
+cycler==0.12.1              # Creación de iteradores complejos (dependencia de matplotlib)
+fonttools==4.62.1           # Manipulación de fuentes tipográficas
+kiwisolver==1.5.0           # Solucionador matemático rápido (dependencia de matplotlib)
+pillow==12.1.1              # Procesamiento y manipulación de imágenes (PIL)
+pyparsing==3.3.2            # Herramienta para crear analizadores de texto sintácticos
+
+# ==========================================
+# CLI (Terminal) & Utilidades de Salida
+# ==========================================
+click==8.3.1                # Creación rápida de interfaces de línea de comandos (CLI)
+typer==0.24.1               # Creación de CLIs basado en Pydantic y tipado
+rich==14.3.3                # Texto enriquecido, tablas y colores en la terminal
+rich-toolkit==0.19.7        # Componentes adicionales para Rich
+tqdm==4.67.3                # Barras de progreso visuales en consola
+shellingham==1.5.4          # Herramienta para detectar qué shell se está utilizando
+
+# ==========================================
+# Serialización, Parsing & Utilidades Generales
+# ==========================================
+python-dotenv==1.2.2        # Carga de variables de entorno desde archivos .env
+orjson==3.11.7              # Analizador (parser) de JSON ultrarrápido
+jiter==0.13.0               # Parser de JSON eficiente (usado internamente por Pydantic)
+ormsgpack==1.12.2           # Serialización de datos en formato MessagePack (rápida)
+msgpack==1.1.2              # Serialización de datos en formato MessagePack (estándar)
+PyYAML==6.0.3               # Procesamiento de archivos YAML
+jsonpatch==1.33             # Aplicación de parches a documentos JSON
+jsonpointer==3.0.0          # Identificación de nodos dentro de un JSON
+python-dateutil==2.9.0.post0 # Extensiones robustas para el manejo de fechas (datetime)
+regex==2026.2.28            # Motor de expresiones regulares alternativo y más potente
+uuid_utils==0.14.1          # Utilidades para la generación rápida de UUIDs
+charset-normalizer==3.4.5   # Detección automática de codificación de texto
+six==1.17.0                 # Librería de compatibilidad entre Python 2 y 3
+tenacity==9.1.4             # Reintentos automáticos para código propenso a fallos
+decorator==5.2.1            # Simplificación en la creación de decoradores
+xxhash==3.6.0               # Algoritmo de hash no criptográfico extremadamente rápido
+zstandard==0.25.0           # Compresión de datos rápida (algoritmo zstd)
+packaging==26.0             # Manejo y parseo de versiones de paquetes de Python
+platformdirs==4.9.4         # Identificación de rutas de directorios estándar del SO
+pooch==1.9.0                # Descarga y almacenamiento en caché de archivos de datos
+lazy-loader==0.5            # Carga perezosa (lazy) de módulos pesados
+cffi==2.0.0                 # Interfaz para llamar código en C desde Python (FFI)
+pycparser==3.0              # Analizador sintáctico de lenguaje C en Python
+rignore==0.7.6              # Herramienta para analizar archivos ignorados (ej. .gitignore)
+annotated-doc==0.0.4        # Utilidades para extraer documentación de tipos anotados
+fastar==0.8.0               # Utilidad secundaria (generalmente vinculada al framework web)
+
+# ==========================================
+# Plantillas & Procesamiento de Markdown
+# ==========================================
+Jinja2==3.1.6               # Motor de plantillas (usado comúnmente para renderizar HTML)
+MarkupSafe==3.0.3           # Escapado seguro de strings para evitar inyecciones en HTML
+markdown-it-py==4.0.0       # Analizador y renderizador de Markdown extensible
+mdurl==0.1.2                # Utilidad para parsear URLs dentro de Markdown
+Pygments==2.19.2            # Resaltador de sintaxis genérico para código fuente
+
+# ==========================================
+# Monitoreo & Diagnóstico del Sistema
+# ==========================================
+sentry-sdk==2.54.0          # Integración con Sentry para monitoreo y rastreo de errores
+distro==1.9.0               # Extracción de información específica del sistema operativo Linux