> 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.md).

# ミニプレム（MiniPrem）

{% hint style="info" %}
**セルフホスト型デジタルヒューマン:** デジタルヒューマンをお客様自身のインフラ上にデプロイし、データ主権・セキュリティ・コンプライアンスを完全にコントロールできます。
{% endhint %}

{% hint style="info" %}
**本ドキュメントの目的:** 本ドキュメントは、ミニプレム（MiniPrem）のインストールおよびご利用に必要な作業内容と情報をお伝えすることを目的に作成・公開しています。\
環境構築・OS・ドライバー等の一般的なサポートは含まれません。範囲外のお問い合わせについては [サポート窓口](https://support.digitalhumans.jp/) までご相談ください。
{% endhint %}

## MiniPrem とは

MiniPrem は、LLM 連携、リアルタイム表情アニメーション、モニタリング機能を備えた、統合的なデジタルヒューマンプラットフォームです。デジタルヒューマンをお客様自身のインフラ上で稼働させることができます。

MiniPrem を動作させるには **Ubuntu 24.04 LTS** 以降が必要です。WSL（Windows Subsystem for Linux）はサポート対象外です。

{% 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="info" %}
**リモート接続によるインストール:** インストール作業はお客様にご準備いただいたリモート接続を通じて実施いたします。\
機材のお預かりやオンサイトでの作業は承っておりません。インストールが完了できなかった場合は、別日程で再度インストール作業を行う場合があります。\
リモート接続環境の構築手順（ngrok TCP + SSH 経由）の詳細は [リモートインストール支援](/dev/miniprem/remote-install-support.md) を参照してください。
{% endhint %}

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

主なデプロイメントオプション:

* **オンプレミス** - お客様自身のハードウェアで稼働させ、データ主権を完全に確保
* **プライベートクラウド** - AWS、Azure、GCP 上のお客様の VPC にデプロイ
* **マネージド Kubernetes** - EKS、AKS、GKE 上の本番運用対応デプロイメント

## アーキテクチャ

MiniPrem は、ユースケースに応じて 2 種類の主要なデプロイメントアーキテクチャをサポートしています。

### クラウドベースデプロイメント（ホスト型 TURN）

MiniPrem を専用サーバーやクラウドインスタンス上で動作させる本番環境向けの構成です。WebRTC 接続のため、グローバル TURN サーバーインフラを利用します。

![TURN を利用したクラウドアーキテクチャ](/files/mOx68E3UynpQhnd4uBCv)

🌐

### スケーラブルなアクセス

グローバル TURN サーバーインフラを介して複数の同時ユーザーに対応

🔒

### 暗号化ストリーム

自動的なネットワーク通過による安全なコミュニケーション

✅

### 高可用性

エンタープライズ導入やマルチロケーション展開に対応

### キオスクデプロイメント（同一マシン構成）

ブラウザと MiniPrem サービスを同一ハードウェア上で動作させる、スタンドアロン環境に最適化された構成です。

![キオスクアーキテクチャ](/files/QVQlhCg2PuZUimCOvVD3)

⚡

### 超低遅延

TURN サーバーを介さない localhost 通信

💻

### オフライン対応

初期設定後はオフラインでも稼働可能

🏪

### 物理ロケーション

展示会、小売店端末、博物館、ヘルスケア施設など

## インストールタイプ

要件に合わせて以下のインストールタイプから選択してください:

| コンポーネント              | デフォルト |  フル | 用途                                     |
| -------------------- | :---: | :-: | -------------------------------------- |
| **Renny**            |   あり  |  あり | 内部音声処理を備えたデジタルヒューマン（レンダラー、開発コード：Renny） |
| **MiniPrem Monitor** |   あり  |  あり | Docker/Kubernetes モニタリングダッシュボード        |
| **vLLM**             |   -   |  あり | LLM 推論サーバー（Gemma3/Mistral）             |
| **Flowise**          |   -   |  あり | ワークフロー自動化プラットフォーム                      |
| **Grafana**          |   -   |  あり | メトリクス可視化                               |
| **Prometheus**       |   -   |  あり | メトリクス収集                                |
| **Redis**            |   -   |  あり | メッセージキューシステム                           |
| **FastWhisper**      |   -   |  あり | GPU アクセラレーション対応の STT（音声認識）             |
| **RIME**（オプション）      |   -   |  あり | 高品質な TTS（音声合成）API                      |

2デフォルトのコンテナ数8-9フルインストールのコンテナ数\~8GBデフォルトの GPU RAM\~16GBフルインストールの GPU RAM

## デプロイメントオプション

| デプロイメント                                                                    | 推奨用途         | セットアップ時間 | スケール       | インフラ             |
| -------------------------------------------------------------------------- | ------------ | -------- | ---------- | ---------------- |
| [**Docker（ローカル）**](/dev/miniprem/docker-deployment.md)                     | 開発、デモ、テスト    | 5〜10 分   | 1〜5 ユーザー   | GPU 搭載シングルマシン    |
| [**AWS EKS**](/dev/miniprem/kubernetes-overview/kubernetes-eks.md)         | AWS での本番運用   | 30〜45 分  | 10〜100 名以上 | Kubernetes クラスター |
| [**Azure AKS**](/dev/miniprem/kubernetes-overview/kubernetes-aks.md)       | Azure での本番運用 | 35〜50 分  | 10〜100 名以上 | Kubernetes クラスター |
| [**マルチクラウド**](/dev/miniprem/kubernetes-overview/kubernetes-multi-cloud.md) | ハイブリッドデプロイ   | 構成により異なる | エンタープライズ   | 複数プロバイダー         |

{% hint style="success" %}
**はじめに:** MiniPrem を初めて利用される方は、[スタートガイド](/dev/miniprem/getting-started.md) から Docker インストールおよび初期セットアップを進めてください。
{% endhint %}

## ガイド

[🤖Renny 連携デジタルヒューマンの設定と管理ガイドを見る →](/dev/miniprem/services/renny.md)[🔬Flowiseワークフロー自動化のセットアップガイドを見る →](/dev/miniprem/services/flowise.md)[🧠vLLM 連携大規模言語モデルの設定ガイドを見る →](/dev/miniprem/services/vllm.md)[📊モニタリングPrometheus と Grafana のセットアップガイドを見る →](/dev/miniprem/services/monitoring.md)[🎤RIME TTSTTS API の連携ガイドを見る →](/dev/miniprem/services/rime.md)[🎙Whisper STT音声認識の設定ガイドを見る →](/dev/miniprem/services/whisper.md)

## API ドキュメント

* [**ヘルスチェック API**](/dev/miniprem/api/health.md) - サービスのヘルスモニタリング用エンドポイント
* [**コンテナログ API**](/dev/miniprem/api/container-logs.md) - Docker コンテナのログアクセス

## トラブルシューティング

{% hint style="warning" %}
**問題が発生した場合:** よくある問題と解決策については [トラブルシューティングガイド](/dev/miniprem/troubleshooting.md) をご確認ください。
{% endhint %}

簡易診断:

* **Docker の問題**: `docker logs <container_name>` でコンテナのログを確認します
* **GPU の問題**: `nvidia-smi` で GPU の状態を確認します
* **サービスの問題**: `./miniprem.sh status` を実行してサービスの稼働状況を確認します

***

## ライセンス

本ドキュメントは MiniPrem プラットフォームの一部であり、MIT ライセンスの下で提供されています。

***

**サポート**: <https://support.digitalhumans.jp/>

**© 2025 UneeQ. All rights reserved.**

<img src="https://cdn.pulse2.com/cdn/2024/12/UneeQ-logo-dark.jpg" alt="デジタルヒューマン ロゴ" width="120">
