diff --git a/content.en/_index.md b/content.en/_index.md index 427b876..376fc15 100644 --- a/content.en/_index.md +++ b/content.en/_index.md @@ -6,27 +6,31 @@ type: docs [[日本語](ja) | English ] -MMDAgent-EX is a research and development platform for spoken dialogue systems, multi-modal interactions and avatar communications using CG avatars. It has been open-sourced since December 2023, with [CG Avatar Gene & Uka](https://www.slp.nitech.ac.jp/en/avatar/). - -This site contains all documents related to MMDAgent-EX. If you are new, please proceed through the tutorials in order. You can also comment at the bottom of each page. +MMDAgent-EX is a research and development platform for spoken dialogue systems, multi-modal interactions and avatar communications using CG avatars. It has been open-sourced since December 2023, with [CG Avatar Gene & Uka](https://www.slp.nitech.ac.jp/en/avatar/). This site contains all documents related to MMDAgent-EX: - Tutorials - Creating Content - Development - Reference Manual -GitHub repositories (bug reports, requests, etc) +If you find bug or mis-information in this site, feel free to add comment at the bottom of each page. + +## For Developers + +See these GitHub repositories for latest codes, issues and discussions. - [MMDAgent-EX](https://github.com/mmdagent-ex/MMDAgent-EX) - [CG Avatar Gene](https://github.com/mmdagent-ex/gene) - [CG Avatar Uka](https://github.com/mmdagent-ex/uka) -- [Example used on this site](https://github.com/mmdagent-ex/example) +- [Example](https://github.com/mmdagent-ex/example) -Contact information +## Contact information -- Twitter/X [@MMDAgentEX](https://twitter.com/MMDAgentEX)（for announcements） +- We are on [Discussions](https://github.com/mmdagent-ex/MMDAgent-EX/discussions) in [MMDAgent-EX GitHub](https://github.com/mmdagent-ex/MMDAgent-EX) - mmdagent-ex-official@lee-lab.org (for inquiries about research, development, and licensing) -- Developed at: [Lee Laboratory, Nagoya Institute of Technology](https://www.slp.nitech.ac.jp/en/) +- Twitter/X [@MMDAgentEX](https://twitter.com/MMDAgentEX)（for announcements only） + +Developed at [Lee Laboratory, Nagoya Institute of Technology, Japan](https://www.slp.nitech.ac.jp/en/). ## See it in action (in Japanese) diff --git a/content.en/docs/00_build.md b/content.en/docs/00_build.md index f3c344d..b845af6 100644 --- a/content.en/docs/00_build.md +++ b/content.en/docs/00_build.md @@ -12,6 +12,10 @@ MMDAgent-EX runs on macOS, Linux, and Windows. It can also runs on WSL2 environm - **Windows**: Windows 11 with Visual Studio 2022 - **Linux on WSL**: Ubuntu-22.04 on WSL2 (v1.2.5.0) on Windows +Windows users can also get pre-built binaries from [GitHub Release page](https://github.com/mmdagent-ex/MMDAgent-EX/releases). + +## コードの入手 + ## Obtaining the Code {{< hint danger >}} @@ -91,7 +95,7 @@ The built executable and plugins will be stored under to the `Release/` director The brew package directory may change depending on your environment, i.e., `/usr/local/` or `/opt/homebrew`. The build script will try to guess the prefix directory by executing `brew --prefix`. If it does not work well, specify the brew prefix path with environment variable `HOMEBREW_PREFIX`. -### Linux +### Linux (Ubuntu, WSL2) The list of required packages is in the `requirements-linux.txt`, so install all the packages listed in it in advance with `apt install`. If you are using `Ubuntu`, you can do all at once as follows: diff --git a/content.ja/_index.md b/content.ja/_index.md index 8c34ad1..597705e 100644 --- a/content.ja/_index.md +++ b/content.ja/_index.md @@ -6,27 +6,28 @@ type: docs [日本語 | [English](/../) ] -MMDAgent-EX はCGアバターを用いた音声対話・マルチモーダル対話・アバターコミュニケーションのための研究開発プラットフォームです。[CGアバター ジェネ・うか](https://www.slp.nitech.ac.jp/avatar/) とともに、2023年12月よりオープンソースで公開されています。 +MMDAgent-EX はCGアバターを用いた音声対話・マルチモーダル対話・アバターコミュニケーションのための研究開発プラットフォームです。[CGアバター ジェネ・うか](https://www.slp.nitech.ac.jp/avatar/) とともに、2023年12月よりオープンソースで公開されています。初めての方は「[MMDAgent-EXとは](docs/about/)」を読んでください。 -このサイトでは MMDAgent-EX に関するすべてのドキュメントが掲載されています。初めての方はチュートリアルから順に読み進めてください。各ページの下部からコメントも行えます。 +このサイトでは MMDAgent-EX に関するチュートリアルから、MMDAgent-EX で再生可能なコンテンツの作成方法、他のサービスやプログラムと連携するための拡張・開発の方法、そして利用可能なすべての仕様やコマンドの一覧まで、すべての最新のドキュメントが掲載されています。初めての方はチュートリアルから順に読み進めてください。 -- チュートリアル -- コンテンツ作成 -- 拡張・開発 -- リファレンスマニュアル +## 研究・開発者の方へ -ソフトウェア・CGアバターは GitHub ので公開しています。バグ報告や要望など、開発に関することは GitHub へお願いします。 +最新のコード、モデル、issue, discussion は下記の GitHub サイトで公開しています。バグ報告、ご要望等は [MMDAgent-EX レポジトリのディスカッション](https://github.com/mmdagent-ex/MMDAgent-EX/discussions) へどうぞ。 -- [MMDAgent-EX](https://github.com/mmdagent-ex/MMDAgent-EX) +GitHubレポジトリ： + +- [MMDAgent-EX GitHub](https://github.com/mmdagent-ex/MMDAgent-EX) - [CGアバター ジェネ / Gene](https://github.com/mmdagent-ex/gene) - [CGアバター うか / Uka](https://github.com/mmdagent-ex/uka) - [Example (本サイトで使用)](https://github.com/mmdagent-ex/example) -その他のコンタクト情報は以下の通りです。 +## 連絡先 + +- 開発者は [MMDAgent-EX の GitHub レポジトリ](https://github.com/mmdagent-ex/MMDAgent-EX)の[Discussions](https://github.com/mmdagent-ex/MMDAgent-EX/discussions) に居ます。 +- E-mail：mmdagent-ex-official@lee-lab.org +- Twitter/X [@MMDAgentEX](https://twitter.com/MMDAgentEX)（更新情報等お知らせのみ） -- Twitter/X [@MMDAgentEX](https://twitter.com/MMDAgentEX)（更新情報等お知らせ） -- 問い合わせ先：mmdagent-ex-official@lee-lab.org （研究・開発・許諾等ご相談） -- 開発元：[名古屋工業大学 李 研究室](https://www.slp.nitech.ac.jp/) +MMDAgent-EX は[名古屋工業大学 李 研究室](https://www.slp.nitech.ac.jp/)にて開発されました。 ## 動作サンプル diff --git a/content.ja/docs/00_build.md b/content.ja/docs/00_build.md index d4e68f4..1cad134 100644 --- a/content.ja/docs/00_build.md +++ b/content.ja/docs/00_build.md @@ -4,13 +4,15 @@ slug: build --- # ビルド -MMDAgent-EX の動作環境は macOS, Linux, Windows である。Windows上での WSL2 もサポートしている。以下の環境でビルド動作を確認している。 +MMDAgent-EX の動作環境は macOS, Linux, Windows です。Windows上での WSL2 もサポートしています。以下の環境でビルド動作を確認しています。本ページの手順でビルドを実行して実行環境を構築してください。 -- **macOS**: M2 Macbook Air / macOS Ventura 13.5 / Sonoma -- **Linux**: Ubuntu-22.04, Ubuntu-20.04 - **Windows**: Windows 11 with Visual Studio 2022 +- **macOS**: M2 Macbook Air / macOS Ventura, Intel Mac / macOS Sonoma +- **Linux**: Ubuntu-22.04, Ubuntu-20.04 - **Linux on WSL**: Ubuntu-22.04 on WSL2 (v1.2.5.0) on Windows +Windows のビルド済み実行バイナリが[GitHubのReleaseページ](https://github.com/mmdagent-ex/MMDAgent-EX/releases)にバージョンごとに置いてあるので、ビルド環境を構築できない場合はそちらをご利用ください。 + ## コードの入手 {{< hint danger >}} @@ -90,7 +92,7 @@ cmake --build build なお brew パッケージの場所は、環境変数 `HOMEBREW_PREFIX` が定義されていればそれを使い、指定されていなければ `brew --prefix` の出力を用います。 -### Linux +### Linux (Ubuntu / WSL2) 必要なパッケージ名の一覧が `requirements-linux.txt` ファイルにあるので、その中に記されているパッケージを全て事前に `apt install` しておく。`Ubuntu` であれば以下の要領で一括で行える。