HumansXドキュメントセンター 公式サイトへ ↗

ASR-LLM-TTS 音声アシスタント

本プロジェクトは、自動音声認識(ASR)、大規模言語モデル(LLM)、音声合成(TTS)の機能を統合した音声対話アシスタントシステムです。フロントエンドとバックエンドを分離したアーキテクチャを採用し、Web 画面での操作と音声対話に対応しています。ユーザーは音声またはテキスト入力でアシスタントとやり取りでき、アシスタントは指示を理解してツール(電卓、音楽プレーヤー、ロボットアーム制御など)を呼び出し、自然な音声で応答します。

主な機能

  • 音声認識(ASR):Sherpa-NCNN を使用したローカル・リアルタイム音声認識
  • 大規模言語モデル(LLM):Volcano Engine の Doubao シリーズと連携し、Function Calling に対応
  • 音声合成(TTS):Volcano Engine の TTS サービスによるストリーミング音声合成と再生
  • Web 画面:Next.js ベースのモダンなフロントエンド画面で、リアルタイム対話に対応
  • レスポンシブデザイン:モバイルとデスクトップの両方に対応し、LAN 内からのアクセスも可能
  • ツールエコシステム:電卓、音楽プレーヤー、ロボットアーム制御、画像認識など
  • 双方向ストリーミング:LLM 出力、TTS 合成、音声再生を並行処理 ⚡
  • リアルタイムインタラクション:WebSocket 通信による低遅延の応答

プロジェクト構成

asr-llm-tts/
├── Frontend/             # 前端项目 (Next.js + TypeScript)
│   ├── docs/             # 前端详细技术文档
│   └── README.md         # 前端概览文档
├── Backend/              # 后端项目 (FastAPI + Python)
│   ├── docs/             # 后端详细技术文档
│   ├── config.yaml       # 全局配置文件
│   ├── server.py         # FastAPI 服务器入口
│   └── README.md         # 后端概览文档
├── docs/                 # 项目文档
├── run.sh                # 一键启动脚本
├── README.md             # 项目总体说明 (本文档)
└── version.md            # 版本更新记录

技術概要

フロントエンド技術スタック

主な構成は以下のとおりです。

  • フレームワーク:Next.js 15.2.4(React 19)+ TypeScript
  • スタイル:TailwindCSS + shadcn/ui コンポーネントライブラリ
  • 3D レンダリング:Three.js(WebGL 3D ライブラリ)
  • 通信:WebSocket によるリアルタイム双方向通信

バックエンド技術スタック

  • フレームワーク:FastAPI + Uvicorn
  • 音声認識:Sherpa-NCNN(ローカル)
  • 大規模言語モデル:Volcano Engine Doubao
  • 音声合成:Volcano Engine TTS

詳細な技術ドキュメントについては、各モジュールの README および docs ディレクトリを参照してください。

クイックスタート

ワンクリック起動(推奨)

起動に成功したら、次のアドレスにアクセスします。

# 启动前后端服务
./run.sh

http://localhost:3000

手動起動

⚙️

# 启动后端
cd Backend
python server.py

# 启动前端
cd Frontend
npm run dev

設定とデプロイ

環境設定

  1. リポジトリをクローンし、依存関係をインストールします

  2. API キーを設定します(Backend/.env ファイル内)

  3. ASR/VAD モデルファイルをダウンロードします

主要な設定ファイル

  • Backend/config.yaml:システム設定

  • Backend/.env:API キー設定

詳細な設定手順については、以下を参照してください。

ASR-LLM-TTS 音声対話アシスタント(バックエンド)

Function Calling ツール

対応ツールの種類

  • 電卓:基本的な数値計算
  • 音楽プレーヤー:ローカル音楽ファイルの再生と音量制御
  • ロボットアーム制御:物体の把持・配置・方向移動(MCP 拡張)
  • 画像認識:物体検出とシーン理解
  • カメラ制御:パン・チルト回転、顔追跡

ツールの詳細な説明については、以下を参照してください。

Function Calling ツール呼び出しシステム

関連ドキュメント

フロントエンドのドキュメント

フロントエンド概要

  • 概要ドキュメント:

ASR-LLM-TTS 音声対話アシスタント(フロントエンド)

  • 詳細な技術ドキュメント:

フロントエンドアーキテクチャ設計の詳細

WebSocket 通信統合ドキュメント

UI コンポーネントシステムドキュメント

状態管理の詳細

国際化システムドキュメント

バックエンド概要

  • 概要ドキュメント:

ASR-LLM-TTS 音声対話アシスタント(バックエンド)​

  • 詳細な技術ドキュメント:

システムアーキテクチャ設計の詳細

Function Calling ツール呼び出しシステム

MCP(Model Context Protocol)統合ドキュメント

オーディオシステム技術ドキュメント

デプロイガイド

WebSocket API リファレンス


技術サポート

資料のダウンロード・技術サポートについては、HumansX株式会社までお問い合わせください。

資料のダウンロード・技術サポートについては、HumansX株式会社までお問い合わせください。