> For the complete documentation index, see [llms.txt](https://docs.digitalhumans.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalhumans.jp/dev/miniprem/getting-started.md).

# はじめに

## ミニプレム（MiniPrem）を始める

{% hint style="info" %}
**クイックスタート:** 本ガイドでは、30 分以内に MiniPrem をインストールおよび設定する手順をご案内します。
{% endhint %}

{% hint style="warning" %}
前提条件を満たす環境の準備はお客様の責任において実施いただきますようお願いいたします。デジタルヒューマン株式会社では前提条件を満たすための環境構築のサポート、ドライバー等の不具合に対する対応作業は提供しておりません。
{% endhint %}

{% hint style="warning" %}
2026年6月現在、デジタルヒューマン株式会社の正式サポート対象はデフォルト（Default Install）の Renny のみです。フルインストール（Full Install）に含まれる Renny 以外のサービス（vLLM、Flowise、RIME AI、NVIDIA RIVA、Whisper など）はサポート対象外です。
{% endhint %}

{% hint style="warning" %}
**同一ホストでの他アプリケーション運用について:** 同一ホストに Web サーバーや LLM など、他のアプリケーションをインストールする場合はお客様の自己責任でお願いいたします。デジタルヒューマン株式会社では、これらに関する一切の情報やサポートを提供いたしません。\
他アプリケーションとの競合等により MiniPrem の再インストールが必要になった場合、所定の作業工賃が発生いたします。
{% endhint %}

{% hint style="info" %}
**インストール作業の進め方:** MiniPrem のインストール作業はお客様にご準備いただいたリモート接続（SSH / ngrok / TeamViewer 等）を通じて実施いたします。機材のお預かりやオンサイトでの作業は承っておりません。リモート接続の準備手順は [リモートインストール支援](/dev/miniprem/remote-install-support.md) をご覧ください。\
インストールが完了できなかった場合は、別日程での再実施となる可能性があります。
{% endhint %}

### 目次

* [前提条件](#prerequisites)
* [インストール](#installation)
* [プラットフォームの管理](#managing-the-platform)
* [動作検証チェックリスト](#verification-checklist)
* [次のステップ](#next-steps)
* [ライセンス](#license)
* [著作権](#copyright)

### OS 要件

{% hint style="warning" %}
**OS 互換性:** MiniPrem は **Ubuntu 24.04 LTS** 以降を必要とします。WSL（Windows Subsystem for Linux）は GPU パススルーおよび Docker ネットワーキングの制限により **サポート対象外** です。
{% endhint %}

{% hint style="warning" %}
**アーキテクチャ:** MiniPrem は **x86-64（Intel / AMD）専用** です。ARM プロセッサ（Apple Silicon、Ampere、AWS Graviton 等）には対応していません。
{% endhint %}

### 前提条件

開始する前に、以下を準備してください。詳細な推奨スペック・パッケージ一覧・事前チェックスクリプト等は [詳細な前提条件](/dev/miniprem/prerequisites.md) をご参照ください。

#### ハードウェア要件

公式の最低要件は以下のとおりです。

* 8GB 以上の VRAM を備えた **NVIDIA GPU（16GB 以上を推奨）**
* 16GB 以上の RAM
* 128GB 以上の空きディスク容量

{% hint style="info" %}
**デジタルヒューマン推奨スペック（日本エンタープライズ運用実績ベース）:** 上記の要件で本番運用するとフレームレート不足やコマ落ちが発生しやすいため、デジタルヒューマン株式会社では以下の構成を推奨します。

* CPU: ハイエンド Intel 第 14 世代 / AMD Zen 5 以降、コア数 8 以上
* RAM: 32GB 以上
* ストレージ: NVMe SSD 256GB 以上（PCIe 4.0 以上）
* GPU: GeForce RTX 4080 以上 / RTX Ada Generation（6000 Ada 等）、GPU メモリ 16GB 以上\
  \
  詳細は [詳細な前提条件（デジタルヒューマン推奨）](/dev/miniprem/prerequisites.md) をご覧ください。
  {% endhint %}

{% hint style="info" %}
**ディスク所要量について:** インストーラーは必要な Docker イメージを自動ダウンロードします。**初期 pull のサイズは合計約 40GB** に達するため、回線速度・ストレージ容量を事前にご確認ください。
{% endhint %}

#### ソフトウェア要件

* Ubuntu 24.04 LTS 以降
* [NVIDIA プロプライエタリドライバー（バージョン 580 以上が必要）](/dev/miniprem/nvidia-drivers.md) — nouveau オープンソースドライバーは互換性がありません
* CUDA Toolkit 12.2 以降（13.0 も使用可能）
* Docker および Docker Compose
* NVIDIA Container Toolkit
* Google Chrome 124 以降

事前に Ubuntu 上へ導入が必要な apt パッケージ（`curl`、`wget`、`git`、`build-essential`、`jq`、`socat`、`smartmontools` 等の 14 パッケージ）の一括インストールコマンドは [詳細な前提条件（デジタルヒューマン推奨）](/dev/miniprem/prerequisites.md#apt-packages) にまとめています。

#### ネットワーク要件

MiniPrem はライセンス認証・シグナリング・TTS（音声合成）・WebRTC 通信のため、外部ネットワークへの安定したアウトバウンド接続を必要とします。

* パケットロス・ジッターのないインターネット接続（WebRTC 品質判定基準・推奨パケットロス率は [ネットワーク要件](/dev/miniprem/network-requirements.md#packet-loss-criteria) を参照）
* ファイアウォール許可リスト（FQDN ホワイトリスト・ポート早見表）: [ネットワーク要件](/dev/miniprem/network-requirements.md)
* P2P / TURN トポロジー別の必要ポート: [ネットワーク要件 - P2P / TURN 構成](/dev/miniprem/network-requirements.md#p2p-turn)
* Azure TTS（音声合成）のリージョン選定（日本から主要 13 リージョンへの RTT 計測指針）: [ネットワーク要件 - Azure TTS リージョン選定](/dev/miniprem/network-requirements.md#azure-tts-region)

{% hint style="info" %}
**情シスへの申請に必要な FQDN・ポート一覧:** 日本のエンタープライズ環境ではアウトバウンド通信が厳しく制限されている場合があります。ファイアウォール例外申請を事前に行うため、[ネットワーク要件](/dev/miniprem/network-requirements.md) ページの早見表をご活用ください。
{% endhint %}

#### 表示端末

デジタルヒューマンを表示する端末は、MiniPrem がインストールされたホストと同一である必要はありません。表示端末側では Google Chrome 124 以降が必要です。

### インストール

#### 1. インストーラーの入手

デジタルヒューマン株式会社が提供する日本向け配布版（デジタルヒューマン配布版）と、UneeQ 公式の GitHub 版の 2 種類があります。

{% tabs %}
{% tab title="デジタルヒューマン配布版（日本国内のお客様向け）" %}

```bash
# インストーラーのダウンロードと解凍
wget hosted-experience.jp/miniprem/miniprem_v1.00.zip
unzip miniprem_v1.00.zip
cd MiniPrem
```

{% hint style="info" %}
デジタルヒューマン配布版は日本国内のお客様向けにデジタルヒューマン株式会社が提供する経路です。ダウンロード URL や認証情報については[サポート窓口](https://support.digitalhumans.jp/)までお問い合わせください。
{% endhint %}
{% endtab %}

{% tab title="UneeQ 公式（GitHub）" %}

```bash
git clone https://github.com/uneeq-digital-humans/miniprem.git
cd miniprem
```

{% endtab %}
{% endtabs %}

#### 2. インストールスクリプトの実行

```bash
./docker/scripts/install_miniprem.sh
```

デジタルヒューマン配布版の場合は次のコマンドで起動します。

```bash
./install_miniprem.sh
```

インストーラーは、**デフォルト（Default Install）**（Renny と内部音声処理）または **フルインストール（Full Install）**（Renny、Flowise、vLLM、Grafana、Prometheus、RIME など、すべてのサービス）のいずれかを選択するよう案内します。 インストーラーはいつでも再実行でき、デフォルト（Default Install）からフルインストール（Full Install）へのアップグレードや選択内容の変更が可能です。

#### 3. 設定値

インストール時に以下の情報が必要になります。

| 設定項目                                | 説明                            | 例                              |
| ----------------------------------- | ----------------------------- | ------------------------------ |
| Digital Human Open Platform Address | シグナリングサービスのアドレス               | api.enterprise.uneeq.io        |
| Digital Human Open Platform API Key | デジタルヒューマン プラットフォーム用の API キー   | your\_uneeq\_api\_key\_here    |
| Tenant ID                           | テナント識別子                       | your\_tenant\_id\_here         |
| Azure Region                        | 音声サービス用の Azure リージョン          | your\_azure\_region            |
| Azure Speech Key                    | Azure 音声サービスの API キー          | your\_azure\_speech\_key\_here |
| Renny Image                         | Renny デジタルヒューマン用の Docker イメージ | facemeproduction/renny:latest  |
| RIME API Key                        | RIME TTS（音声合成）用の API キー       | your\_rime\_api\_key           |
| Huggingface Token                   | Huggingface アクセス用のトークン        | your\_huggingface\_token       |
| UneeQ Harbor Token                  | イメージレジストリアクセス用のトークン           | your\_personal\_access\_token  |

{% hint style="info" %}
**RIME を選択する場合の追加要件:** TTS（音声合成）プロバイダーに RIME を選択する場合、API キーに加えて **quay.io のパスワード** が必要になります。事前にご準備ください。
{% endhint %}

#### 4. インストールの確認

インストール完了後、すべてのサービスが稼働しているか確認します。

```bash
./miniprem.sh status
```

すべてのコンテナが稼働中で健全な状態であることを確認できます。

### プラットフォームの管理

#### サービスの起動

```bash
./miniprem.sh start
```

#### サービスの停止

```bash
./miniprem.sh stop
```

#### ログの確認

```bash
./miniprem.sh logs
```

特定のサービスのログを表示することもできます。

```bash
./miniprem.sh logs renny
./miniprem.sh logs flowise
./miniprem.sh logs vllm
```

#### サービスの再起動

```bash
./miniprem.sh restart
```

### 動作検証チェックリスト

インストール完了後、実行中のセッション内でデジタルヒューマンに対して発話指示を送信し、以下の各機能が正常に動作するかを確認してください。

* [ ] **レンダリング:** デジタルヒューマンがブラウザ上に正しく表示される
* [ ] **TTS（音声合成）:** 指定したテキストから音声が生成・再生される
* [ ] **アニメーション・リップシンク:** 発話内容に合わせて口や表情が動く
* [ ] **会話 AI 接続:** オーケストレーションサービスに接続でき、双方向の会話が成立する

{% hint style="info" %}
上記すべての項目にチェックが入った時点で、MiniPrem の正常なインストール完了とみなすことができます。いずれかが不調の場合は [問題診断ガイド](/dev/miniprem/first-steps.md) をご確認のうえ、[サポート窓口](https://support.digitalhumans.jp/)までご連絡ください。
{% endhint %}

### リモート接続によるインストール作業

デジタルヒューマン株式会社のエンジニアがリモート経由でインストールを支援する場合は、SSH + ngrok 等の経路をお客様側でご準備いただきます。手順・作業後の閉じ込み（root パスワード・SSH・開放ポートの無効化）の詳細は [リモートインストール支援](/dev/miniprem/remote-install-support.md) を参照してください。

{% hint style="warning" %}
**作業後の閉じ込みについて:** インストール作業終了後は、root アカウント / SSH / リモート接続用の開放ポート・サービス（ngrok 等）を必ず無効化・削除してください。セキュリティポリシーや監査要件への適合のために必須の作業です。
{% endhint %}

### 次のステップ

MiniPrem プラットフォームが起動したら、次の手順に進んでください。

1. [Flowise の設定](https://uneeq-digital-humans.github.io/miniprem/#/guides/flowise) — 会話フローのセットアップ
2. [パフォーマンスのモニタリング](https://uneeq-digital-humans.github.io/miniprem/#/guides/monitoring) — Grafana ダッシュボードの活用
3. [Renny のカスタマイズ](https://uneeq-digital-humans.github.io/miniprem/#/guides/renny) — 用途に合わせた Renny（レンダラー、開発コード：Renny）の調整

{% hint style="info" %}
**問題が発生した場合:** [サポート窓口](https://support.digitalhumans.jp/)へ連絡する前に、初心者向けの [問題診断ガイド](/dev/miniprem/first-steps.md) をご確認ください。
{% endhint %}