Repolode
codelion

codelion/adaptive-classifier

Librería de Python para clasificar textos que aprende de nuevos ejemplos y clases en tiempo de ejecución, con confianza calibrada y detección de datos fuera de distribución.

Estrellas
578
Forks
43
Issues abiertos
2
Último commit
hace 5 días

¿Qué es?

Adaptive Classifier es una librería de Python basada en PyTorch para clasificar textos, construida sobre encoders de transformers de HuggingFace. Cada clase se representa mediante embeddings prototipo almacenados con FAISS, y se combina una pequeña red neuronal entrenable con la similitud entre prototipos para generar predicciones. Es posible añadir nuevos ejemplos y clases en tiempo de ejecución sin volver a entrenar el modelo completo, y también eliminar ejemplos o clases más adelante.

La librería también cubre los aspectos operativos de un clasificador: calibrar las puntuaciones de confianza con datos reservados para validación, devolver conjuntos de predicciones con un objetivo de cobertura, abstenerse ante entradas con baja confianza o fuera de distribución, sugerir textos sin etiquetar para su anotación y detectar cambios en el tráfico entrante. Los modelos se pueden guardar localmente o subir a HuggingFace Hub, y también se incluye la exportación a ONNX para acelerar la inferencia en CPU.

Ofrece un clasificador multietiqueta, un estimador compatible con scikit-learn y un módulo para servirlo mediante HTTP. El proyecto también incluye un modo experimental de clasificación estratégica que combina predicciones con un modelo basado en costes de manipulación adversarial.

Funciones clave

  • 01Añade nuevas clases y ejemplos en tiempo de ejecución sin volver a entrenar el modelo completo
  • 02Elimina ejemplos incorrectos o clases completas después del entrenamiento
  • 03Calibra la confianza y devuelve conjuntos de predicciones con una cobertura objetivo
  • 04Detecta entradas fuera de distribución y puede abstenerse de clasificarlas
  • 05Sugiere textos sin etiquetar para su etiquetado e informa sobre cambios en los datos
  • 06Exporta modelos ONNX para acelerar la inferencia en CPU y ofrece un servidor HTTP

Casos de uso

  • Dirigir tickets de soporte o correos electrónicos a categorías que cambian con el tiempo
  • Clasificar contenido en el que aparecen nuevas etiquetas con frecuencia y volver a entrenar resulta costoso
  • Crear un clasificador de textos con un Pipeline de scikit-learn y validación cruzada
  • Dirigir consultas de LLM a distintos niveles de modelos según su complejidad prevista

Inicio rápido

  1. 1

    Instala la biblioteca desde PyPI

    pip install adaptive-classifier
  2. 2

    Importa el clasificador e inicialízalo con un modelo de HuggingFace

  3. 3

    Añade ejemplos de entrenamiento con sus etiquetas

  4. 4

    Llama a predict con texto nuevo para obtener las confianzas de cada clase

Antes de usarlo

  • Las predicciones dependen del encoder de HuggingFace elegido, y los ejemplos del README descargan modelos Transformer de gran tamaño.

En colecciones

Temas

#text-classification#continuous-learning#transformers#pytorch#faiss#onnx#online-learning#nlp#adaptive-learning#adaptive-neural-network

Preguntas frecuentes

¿Qué es adaptive-classifier?
Librería de Python para clasificar textos que aprende de nuevos ejemplos y clases en tiempo de ejecución, con confianza calibrada y detección de datos fuera de distribución. Adaptive Classifier es una librería de Python basada en PyTorch para clasificar textos, construida sobre encoders de transformers de HuggingFace. Cada clase se representa mediante embeddings prototipo almacenados con FAISS, y se combina una pequeña red neuronal entrenable con la similitud entre prototipos para generar predicciones. Es posible añadir nuevos ejemplos y clases en tiempo de ejecución sin volver a entrenar el modelo completo, y también eliminar ejemplos o clases más adelante.
¿adaptive-classifier es gratuito? ¿Qué licencia tiene?
adaptive-classifier es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿adaptive-classifier sigue mantenido?
Mantenimiento activo. El último commit de adaptive-classifier fue el 2 nov 2026.
¿Para qué puedo usar adaptive-classifier?
Dirigir tickets de soporte o correos electrónicos a categorías que cambian con el tiempo Clasificar contenido en el que aparecen nuevas etiquetas con frecuencia y volver a entrenar resulta costoso Crear un clasificador de textos con un Pipeline de scikit-learn y validación cruzada Dirigir consultas de LLM a distintos niveles de modelos según su complejidad prevista
¿Cómo se instala adaptive-classifier?
Instala la biblioteca desde PyPI: pip install adaptive-classifier Importa el clasificador e inicialízalo con un modelo de HuggingFace Añade ejemplos de entrenamiento con sus etiquetas Llama a predict con texto nuevo para obtener las confianzas de cada clase
¿Dónde consigo adaptive-classifier?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/codelion/adaptive-classifier

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados