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エージェントを爆速で開発できるフレームワーク」です。


あなただけのAIを創造!SillyTavernで広がるLLM活用の世界

皆さん、焼肉の火加減を完璧に操るように、AIとの会話も意のままに操りたいと思いませんか?SillyTavernはまさにそんな「AI会話の焼肉奉行」になるための強力なツールなんです!一言で言うと、SillyTavernは「LLM(大規模言語モデル)を使いこなすための、めちゃくちゃ高機能なユーザーインターフェース」です。単なるチャット画面とは一線を画し、AIとの対話をより深く、よりパーソナルに、そしてよりクリエイティブにするための機能が満載されています。


AI-Engineering-Hub: ソフトウェアエンジニアのための実践的AI開発ガイド

このリポジトリは、AIを学びたい、あるいはプロジェクトに組み込みたいと考えているエンジニアにとって、多くのメリットを提供します。実践的な知識の習得 理論だけでなく、実際のコード例やプロジェクトを通じてLLMやRAGの仕組みを理解できます。これにより、単なる知識としてではなく、動くものとして技術を習得できるのが大きな強みです。


PythonでAIを分業させる技術:microsoft/agent-frameworkで効率化

このフレームワークは、まるでドラマの名探偵チームを結成して、複雑な事件(タスク)を連携して解決していくようなイメージで捉えると分かりやすいですよ!‍♂このフレームワークは、AIエージェントを構築、連携、デプロイするための強力なツールキットです。Pythonと


論理的な情報検索を実現:PageIndexによる次世代RAGシステムの構築

PageIndexは、従来のVector-Based RAG (Retrieval-Augmented Generation)とは一線を画す、新しい推論ベースのRAGフレームワークです。従来のRAGでは、ドキュメントを一定のサイズでチャンク(断片)に区切り、それをベクトル化(埋め込み)してデータベースに保存し、質問のベクトルと類似度の高いチャンクを検索していました。


ソフトウェアエンジニアが知っておくべき「HumanLayer」の安全設計

「HumanLayer」と聞くと、なんだかSF映画に出てくる怪しげなテクノロジーのように聞こえるかもしれませんね。まるで、AIが未来を占ってくれるけど、本当に信じていいの?と不安になるような…(笑)。でも、心配ご無用!これは決して怪しい占いではありません。むしろ、AIがより安全に、そして信頼できる形で「現実世界」と関わるための、とても重要な「安全装置」なんです。


【徹底解剖】秘密のクローゼットをエンジニアの手で。OpenClawの導入からサンプルコードまで

例えが「ランジェリーショップで悩む彼女」…? OK、ちょっと独特だけど、その「どれも素敵で選べない!」「私にぴったりなのはどれ?」っていうワクワクと不安が入り混じった感じ、エンジニアが新しいツールを触る時の高揚感に近いかもしれないね。「これ、私の生活(開発環境)に馴染むかな…?」って鏡の前で合わせるような気持ちで読んでみて!


AIの思考が丸見えに! ヒューマン・イン・ザ・ループを実現する新世代Webエージェントフレームワーク

「microsoft/magentic-ui」っていう、なんともセクシーで未来的な響きのこのプロジェクト、ウチの可愛いエンジニアちゃんたちから見て、どう役立つのか、ママがとびっきり分かりやすく、そして優しく教えてあげるわね。これはね、Microsoftが研究プロトタイプとして公開している、「人間中心のウェブエージェント」を作るためのフレームワークなの。


1コイン(無料)で始める AI エージェント統合プラットフォーム:AionUi 導入戦記

AionUi について興味を持ってくれて嬉しいよ。これは一言で言うと、CLI(コマンドライン)ベースのAIエージェントたちに、「最高に使いやすいコックピット(GUI)」を後付けしてくれるオープンソースプロジェクトなんだ。最近、Claude Code や Goose CLI みたいに、ターミナルで爆速で動くAIツールが増えているよね。でも、「ずっと黒い画面だと疲れるな」とか「チャット履歴をもっと直感的に管理したい」って思うこともあるはず。そこを解決するのがこのツールさ。