Repolode
undertheseanlp

undertheseanlp/underthesea

Kit de herramientas de Python que combina un framework de agentes LLM multimodelo sin dependencias con herramientas de PLN en vietnamita para segmentación de palabras, NER y análisis de sentimiento.

Estrellas
1,808
Forks
306
Issues abiertos
53
Último commit
anteayer

¿Qué es?

Underthesea es un paquete de Python con dos componentes principales. El primero es un kit de herramientas para agentes que se comunica con OpenAI, Azure OpenAI, Anthropic Claude y Google Gemini usando solo la biblioteca estándar de Python, por lo que no necesita los SDK de los proveedores. Incluye llamadas a herramientas, streaming, ejecuciones en varias sesiones con transferencia de contexto, trazas locales en JSON con integración opcional con Langfuse y un servidor del protocolo A2A con una interfaz de chat incluida.

El segundo componente es un conjunto de herramientas de procesamiento del lenguaje natural en vietnamita. Incluye segmentación de oraciones y palabras, etiquetado POS, reconocimiento de entidades nombradas, clasificación de texto, análisis de sentimiento, restauración de diacríticos, análisis de dependencias, traducción y conversión de texto a voz. Cada pipeline se ofrece como una llamada a una función sencilla, como word_tokenize o ner.

Funciones clave

  • 01Se comunica con OpenAI, Azure OpenAI, Anthropic y Gemini sin depender de los SDK de los proveedores.
  • 02Admite llamadas a herramientas, salida en streaming y 12 herramientas integradas.
  • 03Ejecuta tareas largas en varias sesiones con transferencia estructurada.
  • 04Registra localmente cada llamada del agente, con compatibilidad opcional con Langfuse.
  • 05Ofrece agentes mediante el protocolo A2A, con un AgentCard y una interfaz de chat incluida.
  • 06Ofrece segmentación de palabras en vietnamita, etiquetado POS, NER y análisis de sentimiento.

Casos de uso

  • Crear un agente de Python que cambie entre OpenAI, Claude o Gemini sin SDK adicionales.
  • Procesar texto en vietnamita para búsquedas, clasificación o extracción de información.
  • Añadir trazas y observabilidad a las llamadas de agentes LLM durante el desarrollo.
  • Exponer un agente de Python como servicio A2A con una interfaz de chat sencilla.

Inicio rápido

  1. 1

    Instala el paquete desde PyPI

    pip install underthesea
  2. 2

    Configura una clave de API para un proveedor (por ejemplo, OpenAI)

    export OPENAI_API_KEY=sk-...
  3. 3

    Crea un agente con el proveedor detectado automáticamente y envía un mensaje

Antes de usarlo

  • Las funciones del agente requieren una clave de API de OpenAI, Azure OpenAI, Anthropic o Google Gemini.

En colecciones

Temas

Preguntas frecuentes

¿Qué es underthesea?
Kit de herramientas de Python que combina un framework de agentes LLM multimodelo sin dependencias con herramientas de PLN en vietnamita para segmentación de palabras, NER y análisis de sentimiento. Underthesea es un paquete de Python con dos componentes principales. El primero es un kit de herramientas para agentes que se comunica con OpenAI, Azure OpenAI, Anthropic Claude y Google Gemini usando solo la biblioteca estándar de Python, por lo que no necesita los SDK de los proveedores. Incluye llamadas a herramientas, streaming, ejecuciones en varias sesiones con transferencia de contexto, trazas locales en JSON con integración opcional con Langfuse y un servidor del protocolo A2A con una interfaz de chat incluida.
¿underthesea es gratuito? ¿Qué licencia tiene?
underthesea es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿underthesea sigue mantenido?
Mantenimiento activo. El último commit de underthesea fue el 20 oct 2026.
¿Para qué puedo usar underthesea?
Crear un agente de Python que cambie entre OpenAI, Claude o Gemini sin SDK adicionales. Procesar texto en vietnamita para búsquedas, clasificación o extracción de información. Añadir trazas y observabilidad a las llamadas de agentes LLM durante el desarrollo. Exponer un agente de Python como servicio A2A con una interfaz de chat sencilla.
¿Cómo se instala underthesea?
Instala el paquete desde PyPI: pip install underthesea Configura una clave de API para un proveedor (por ejemplo, OpenAI): export OPENAI_API_KEY=sk-... Crea un agente con el proveedor detectado automáticamente y envía un mensaje
¿Dónde consigo underthesea?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/undertheseanlp/underthesea

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

Proyectos relacionados