AI音声対話アプリを爆速開発!TEN-framework入門


AI音声対話アプリを爆速開発!TEN-framework入門

TEN-framework/ten-framework

2025-09-19

TEN-frameworkは、リアルタイムの音声AIエージェントを構築するためのオープンソースフレームワークです。これを使うと、ビデオや音声を使った対話型AIアプリケーションを簡単に作ることができます。音声認識、自然言語処理、音声合成といった、複数のAI技術を統合して、まるで人間と話しているかのようなスムーズな会話を実現します。

たとえば、次のようなアプリケーションを構築できます。

カスタマーサポートボット
ユーザーからの質問にリアルタイムで回答し、問題解決を支援します。

教育向けAIアシスタント
学習者が発音練習をしたり、質問したりするのを助けます。

バーチャルキャラクター
ゲームやメタバースの世界で、ユーザーと自然に会話するキャラクターを作れます。

通常、音声AIエージェントをゼロから作ろうとすると、音声認識ライブラリ、自然言語理解(NLU)モデル、音声合成ライブラリなどを個別に選定し、連携させる必要があります。これは非常に手間がかかります。

TEN-frameworkは、これらの機能を一つのパッケージに統合してくれているので、開発者は煩雑な統合作業から解放され、アプリケーションのロジックやユーザー体験の向上に集中できます。

このフレームワークは、リアルタイムでの処理に特化して設計されています。音声認識結果がすぐにNLUモデルに渡され、その応答が迅速に音声合成されるため、会話の遅延がほとんどありません。

これは、ユーザーが待たされることなく、ストレスなく会話を続けられるという点で、ユーザー体験を劇的に向上させます。

TEN-frameworkはモジュール式の設計になっています。特定のモジュール(例
音声認識エンジンやNLUモデル)を、プロジェクトの要件に合わせて、別のものに簡単に差し替えることができます。

たとえば、初期はオープンソースのモデルを使っていたけれど、商用サービスに切り替える必要が出た場合でも、コアロジックを大きく変更することなく対応できます。

TEN-frameworkはPythonで書かれており、pipを使って簡単にインストールできます。

まず、Pythonがインストールされていることを確認してください。

ターミナルを開き、以下のコマンドを実行します。

pip install ten-framework

フレームワークは、様々なモジュールと連携します。例えば、音声認識には whisper-onnx、音声合成には xtts-onnx が推奨されています。これらも pip でインストールできます。

pip install "ten-framework[whisper-onnx, xtts-onnx]"

このコマンドは、TEN-framework本体に加えて、推奨される音声認識・合成モデルも一緒にインストールしてくれます。

簡単な「Hello World」的な対話エージェントを作成してみましょう。このコードは、マイクからの入力を受け取り、認識した内容に応じて応答を生成し、それを音声として再生します。

import asyncio
from ten_framework import Agent

# エージェントの作成
agent = Agent()

# 対話フローの定義
# ユーザーの発言を認識して、応答を決定します
async def conversation_flow(agent_context):
    while True:
        # ユーザーの発言を待つ
        print("マイク入力待ち...")
        user_utterance = await agent_context.recognize_speech()
        print(f"ユーザー: {user_utterance}")

        # 応答の決定
        response = ""
        if "こんにちは" in user_utterance:
            response = "こんにちは!何かお手伝いできることはありますか?"
        elif "ありがとう" in user_utterance:
            response = "どういたしまして!"
        else:
            response = "すみません、よく聞き取れませんでした。"

        # 応答を音声で再生
        print(f"エージェント: {response}")
        await agent_context.synthesize_speech(response)

# メイン関数の実行
async def main():
    await agent.run_conversation(conversation_flow)

if __name__ == "__main__":
    asyncio.run(main())

Agent()
TEN-frameworkの核心となる Agent クラスをインスタンス化します。

conversation_flow(agent_context)
実際の対話ロジックを記述する非同期関数です。

agent_context.recognize_speech()
マイクからの音声を認識し、テキストに変換します。

agent_context.synthesize_speech(response)
テキストを音声に変換して再生します。

asyncio.run(main())
非同期処理を開始します。

このシンプルなコードだけで、リアルタイム音声対話の骨組みができてしまいます。あとは、conversation_flow のロジックをより複雑にしたり、外部APIと連携させたりすることで、高度なAIエージェントに進化させることができます。


TEN-framework/ten-framework




【爆速開発】LiveKit Agentsで作る、アサヒ級にキレのあるリアルタイムAIエージェント

「AIとリアルタイムで会話する」という体験を、日本の4大ビールメーカーのブランドイメージになぞらえて、その魅力と実装方法を紐解いていきましょう!LiveKit Agentsを一言で言うと、「超低遅延で動くAIエージェントを爆速で開発できるフレームワーク」です。


【脱・手作業】Reactエンジニアよ、動画編集もコードで「自動課金」せよ!Remotion入門

まさにRemotionは、私たちが普段ウェブサイトを作るのと同じ感覚で、Reactのコンポーネントを組み合わせて「MP4動画」を錬成できるライブラリです。ゲーム課金に例えるなら、「ガチャの演出をポチポチ手で作るんじゃなくて、スクリプトを組んで全パターンの排出アニメーションを自動生成する」みたいなチート級の効率化が可能になります。


戦国エンジニア入門:Rust製AIツール vibeで音声データに革命を

さあ、時は戦乱の世、まさに百花繚乱の技術が鎬を削る時代。 あなたの領地(プロジェクト)では、日々、多種多様な言葉(音声データ)が飛び交っています。 しかし、その言葉を文字として記録する作業は、手間暇かかる退屈な作業…まるで、毎日、何千何万もの文字を手書きで書き写すかのようです。


ソフトウェアエンジニア必見!12-factor-agentsでLLMアプリの悪夢を打ち砕く方法

プロダクション環境で顧客に安心して使ってもらえるLLM(大規模言語モデル)搭載ソフトウェアを開発する…それは、まるで霧に包まれた夜の森を進むようなもの。一歩間違えれば、魑魅魍魎(ちみもうりょう)が跋扈するデバッグの沼に引きずり込まれ、悪夢のようなパフォーマンス問題に苛まれるだろう。しかし、恐れることはない。我々ソフトウェアエンジニアには、この暗闇を照らす灯台がある。それが「12-factor-agents」の原則だ!


コントで学ぶ oraios/serena の真実:未来のプログラミングツール

OrAIos/Serenaは、AIを活用したコーディングエージェントツールキットで、セマンティック検索とコード編集の能力を提供します。MCPサーバーとAgnoの統合により、開発プロセスを劇的に効率化する可能性を秘めています。ソフトウェアエンジニアの視点から、その魅力と活用法を分かりやすく解説しましょう。


銭形警部も追いきれない!?ローカルAIアシスタント「moltbot」完全ガイド

今回は、巷で話題の 「moltbot/moltbot」 について解説するぜ。ソフトウェアエンジニアの視点で見ると、こいつはただのチャットボットじゃない。まるで次元がコンマ数秒で狙い撃つような、鋭い「パーソナルAIアシスタント」なんだ。不二子ちゃんに振り回されるのはゴメンだが、この moltbot は君の指示に忠実だ。


ランジェリーショップで学ぶ!AIアプリ開発の成功事例集

彼女さんが最高のランジェリーを選ぼうと一生懸命悩んでいるように、私たちソフトウェアエンジニアも、最高のシステムをどうやって作るか、日々頭を悩ませています。 そんな時に役立つのが、今回ご紹介する「Arindam200/awesome-ai-apps」なんです。


コンテキストスイッチをゼロへ。Open-source AI Coworker「Rowboat」導入ガイド

「投資詐欺に注意」という標語のように、IT業界も「 AI ツールなら何でも魔法のように解決してくれる」という甘い言葉には注意が必要ですが、この Rowboat は、エンジニアにとってかなり「堅実で実利のある」ツールになり得るポテンシャルを秘めています。


ソフトウェアエンジニアよ、これが最前線だ!"awesome-generative-ai"徹底解説

俺たちソフトウェアエンジニアにとって、この「awesome-generative-ai」はまさに宝の山だぜ!なんでかって?最新トレンドのキャッチアップ 生成AIの分野は日進月歩どころか秒進分歩ってくらい進化が速い。このリストを見れば、今どんな技術がアツいのか、どんなプロジェクトが注目されてるのかが、一目でわかる。