Files
xiaozhi-esp32/README_ja.md
Xiaoxia 89674f8838 v2.2.0: Add bread-compact-nt26 board (#1663)
* Refactor application error handling and improve network task logic

- Updated error handling for modem initialization failure in Application::Initialize().
- Added new error message for modem initialization in English and Chinese language files.
- Simplified lambda captures in NetworkTask to avoid unnecessary references.
- Set main task priority in Application::Run() for better performance.

* Add support for Bread Compact NT26 board

- Introduced new board configuration for Bread Compact NT26 in CMakeLists.txt and Kconfig.
- Added board-specific implementation in compact_nt26_board.cc and nt26_board.cc.
- Created configuration files for NT26, including config.h and config.json.
- Updated dependencies in idf_component.yml to include uart-eth-modem.
- Translated error messages in config.h for OLED display type selection to English.
- Enhanced display and button initialization logic for NT26 board.

* Update project version and improve build configuration

- Updated project version from 2.1.0 to 2.2.0 in CMakeLists.txt.
- Enabled minimal build configuration to include only essential components.
- Updated README files to replace QQ group links with Discord links for community engagement.

* Update Bread Compact NT26 board configuration name in config.json

* fix compile errors

* Update uart-eth-modem dependency format in idf_component.yml

* fix esp32 compiling errors

* Update CMakeLists.txt to change component dependency from REQUIRES to PRIV_REQUIRES for esp_pm, esp_psram, and esp_driver_gpio

* Refactor CMakeLists.txt to explicitly list board common source files and update include directories for better clarity and organization.

* Add esp_driver_ppa as a dependency in CMakeLists.txt
2026-01-19 21:46:21 +08:00

11 KiB
Raw Blame History

MCP ベースのチャットボット

(日本語 | 中文 | English

はじめに

👉 人間AIにカメラを装着 vs AIその場で飼い主が3日間髪を洗っていないことを発見【bilibili】

👉 手作りでAIガールフレンドを作る、初心者入門チュートリアル【bilibili】

シャオジーAIチャットボットは音声インタラクションの入口として、Qwen / DeepSeekなどの大規模モデルのAI能力を活用し、MCPプロトコルを通じてマルチエンド制御を実現します。

MCPであらゆるものを制御

バージョンノート

現在のv2バージョンはv1パーティションテーブルと互換性がないため、v1からv2へOTAでアップグレードすることはできません。パーティションテーブルの詳細については、partitions/v2/README.mdをご参照ください。

v1を実行しているすべてのハードウェアは、ファームウェアを手動で書き込むことでv2にアップグレードできます。

v1の安定版は1.9.2です。git checkout v1でv1に切り替えることができます。v1ブランチは2026年2月まで継続的にメンテナンスされます。

実装済み機能

  • Wi-Fi / ML307 Cat.1 4G
  • オフライン音声ウェイクアップ ESP-SR
  • 2種類の通信プロトコルに対応Websocket または MQTT+UDP
  • OPUSオーディオコーデックを採用
  • ストリーミングASR + LLM + TTSアーキテクチャに基づく音声インタラクション
  • 話者認識、現在話している人を識別 3D Speaker
  • OLED / LCDディスプレイ、表情表示対応
  • バッテリー表示と電源管理
  • 多言語対応(中国語、英語、日本語)
  • ESP32-C3、ESP32-S3、ESP32-P4チッププラットフォーム対応
  • デバイス側MCPによるデバイス制御音量・明るさ調整、アクション制御など
  • クラウド側MCPで大規模モデル能力を拡張スマートホーム制御、PCデスクトップ操作、知識検索、メール送受信など
  • カスタマイズ可能なウェイクワード、フォント、絵文字、チャット背景、オンラインWeb編集に対応 (カスタムアセットジェネレーター)

ハードウェア

ブレッドボード手作り実践

Feishuドキュメントチュートリアルをご覧ください

👉 「シャオジーAIチャットボット百科事典」

ブレッドボードのデモ:

ブレッドボードデモ

70種類以上のオープンソースハードウェアに対応一部のみ表示

ソフトウェア

ファームウェア書き込み

初心者の方は、まず開発環境を構築せずに書き込み可能なファームウェアを使用することをおすすめします。

ファームウェアはデフォルトで公式 xiaozhi.me サーバーに接続します。個人ユーザーはアカウント登録でQwenリアルタイムモデルを無料で利用できます。

👉 初心者向けファームウェア書き込みガイド

開発環境

  • Cursor または VSCode
  • ESP-IDFプラグインをインストールし、SDKバージョン5.4以上を選択
  • LinuxはWindowsよりも優れており、コンパイルが速く、ドライバの問題も少ない
  • 本プロジェクトはGoogle C++コードスタイルを採用、コード提出時は準拠を確認してください

開発者ドキュメント

大規模モデル設定

すでにシャオジーAIチャットボットデバイスをお持ちで、公式サーバーに接続済みの場合は、xiaozhi.me コンソールで設定できます。

👉 バックエンド操作ビデオチュートリアル(旧インターフェース)

関連オープンソースプロジェクト

個人PCでサーバーをデプロイする場合は、以下のオープンソースプロジェクトを参照してください

シャオジー通信プロトコルを利用した他のクライアントプロジェクト:

プロジェクトについて

これはエビ兄さんがオープンソースで公開しているESP32プロジェクトで、MITライセンスのもと、誰でも無料で、商用利用も可能です。

このプロジェクトを通じて、AIハードウェア開発を理解し、急速に進化する大規模言語モデルを実際のハードウェアデバイスに応用できるようになることを目指しています。

ご意見やご提案があれば、いつでもIssueを提出するか、Discord または QQグループ1011329060 にご参加ください。

スター履歴

Star History Chart