undertheseanlp/underthesea

Underthesea - AI Assistant

What it solves

Underthesea は、エージェント型 AI フレームワークとベトナム語向けの専門自然言語処理（NLP）ツールを組み合わせた包括的なツールキットです。開発者は複数の LLM プロバイダーとやり取りし、外部ツールを利用し、高精度でベトナム語テキストを処理できる AI エージェントを構築できます。

How it works

ツールキットは主に 2 つのコンポーネントに分かれています。

  1. Agentic AI Framework：Python の標準ライブラリだけで LLM API（OpenAI、Azure OpenAI、Anthropic Claude、Google Gemini）と直接通信する軽量システムです。ツール呼び出しループ、ストリーミング機能、長時間タスク用のセッション管理を備えています。
  2. Vietnamese NLP Suite：ベトナム語テキスト向けの専門パイプラインのコレクションで、単語分割、固有表現抽出（NER）、感情分析、依存構造解析を含みます。

さらに、JSON‑RPC over HTTP/SSE を介してエージェントを公開する A2A（Agent-to-Agent）サーバ実装と、バンドルされたチャット UI も提供します。

Who it’s for

汎用的なエージェント機能とベトナム語に特化した深い言語処理の両方を必要とする AI アプリケーションを構築する開発者向けです。

Highlights

  • Multi-Provider Support：OpenAI、Azure、Anthropic、Gemini とのネイティブ統合。
  • Zero External Dependencies for Agents：urllib と json を使用して API 通信を行い、パッケージ肥大化を抑制。
  • Built-in Tools：電卓、ウェブ検索、Wikipedia、Python 実行など 12 のデフォルトツールを搭載。
  • Observability：ローカルでのトレース機能（JSON 保存）と Langfuse への対応。
  • Vietnamese NLP Pipeline：ベトナム語向けのトークン化、品詞タグ付け、NER、感情分析ツールを網羅。
  • A2A Protocol：エージェントを ASGI アプリとして簡単にデプロイでき、Discoverable な AgentCard を提供。