# インストール

MiniPremにつきましては、[こちら](/dev/miniprem/miniprem-readme.md)のページをかならずお読みいただき、理解頂いた上でご利用頂いております。

## 概要

本ドキュメントは、**MiniPrem（ミニプレム）** デジタルヒューマン レンダラー（Renny）のインストールスクリプト（`install_miniprem.sh`）の動作・設定内容・運用上の注意点を、エンジニアや運用担当者向けに詳細解説したものです。

### インストールタイプ

MiniPremは2つのインストールタイプを提供しています。

**1. デフォルトインストール**（サポート対象）

1. Renny（デジタルヒューマンレンダラー）
2. 指定TTSプロバイダー（Azure/Eleven Labs）

**2. フルインストール**（サポート対象外）

1. Renny（デジタルヒューマンレンダラー）
2. 選択したTTSプロバイダー（Azure/Eleven Labs/RIME）
3. vLLM（大規模言語モデル）
4. Flowise（チャットフロー管理）
5. Whisper/FastWhisper（音声認識）
6. Grafana/Prometheus（モニタリング）
7. Redis（キャッシュ）
8. ログストリーマー

## 主要機能

### 環境チェック機能

インストーラーは以下の項目を自動的に確認します：

* **ハードウェア要件**
  * GPU（NVIDIA RTX 4080以上）
  * メモリ（32GB以上）
  * CPU（8コア以上）
  * ストレージ（256GB以上のNVMe SSD）
* **ソフトウェア要件**
  * Ubuntu 24.04
  * NVIDIAドライバー（535.183.01以降、nvidia-driver-580を推奨）
  * CUDA（12.2以降 / 13.0使用可）
  * Docker
  * Google Chrome（124以降）
* **ポート競合チェック**
  * 既存のMiniPremコンテナの停止
  * ローカルサービス（Redis等）の競合検出

1. **インストーラーのダウンロード**

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

   # インストール開始
   ./install_miniprem.sh
   ```
2. **設定入力**

   インストール中に以下の情報を入力します。お客様の環境を使用する場合はAPIのキーの提供が必要です：

   * **共通設定**
     * Platform APIキー
     * テナントID
     * TTSプロバイダー別設定
       * Azure: `リージョン`、`Speech APIキー`
       * Eleven Labs: `APIキー`
       * RIME: `APIキー`、`quay.ioパスワード`

   **インストールスクリプト　オプション例**

   ```bash
   ./install_miniprem.sh \
     --platform-address <URL> \
     --platform-key <APIキー> \
     --tenant-id <TenantID> \
     --azure-region <リージョン名> \
     --azure-speech-key <Azure音声キー> \
     --renny-image <image>
   ```
3. **セットアップ**

   インストーラーは以下を自動的に実行します：

   * Dockerとnvidia-container-toolkitのインストール
   * 必要なDockerイメージのダウンロード（約80GB）
   * 環境変数の設定（`docker-compose.env`）と`docker-compose.default.yml` か `docker-compose.yml`の更新
   * サービスの起動

### インストール後のサービス管理

詳細は [操作ガイド](/dev/miniprem/miniprem-usage.md) をご覧下さい。

**サービスの起動**

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

**サービスの停止**

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

**サービス状態の確認**

```bash
sudo docker ps
```

**重複インストール**

インストーラーは既存のMiniPremインストールを検出し、警告を表示します。複数のインストールは競合を引き起こす可能性があるため、1つのインストールのみを使用してください。

**アクセスポイント**

インストール完了後、以下のサービスにアクセス可能：

* **Flowise UI**: [http://localhost:3000](http://localhost:3000/)
* **Renny Health Check**: <http://localhost:8081/health>
* **Grafana** (フルインストール): [http://localhost:3001](http://localhost:3001/)
* **vLLM API** (フルインストール): <http://localhost:8000/v1/models>

**環境変数**

主要な環境変数（`docker-compose.env`）：

```bash
# Platform設定
DHOP_ADDRESS=wss:[URL]
DHOP_APIKEY=[your-api-key]
DHOP_TENANTID=[your-tenant-id]

# Azure TTS設定（Azureを選択した場合）
AZURE_REGION=[your-region]
AZURE_SPEECH_KEY=[your-speech-key]

# Eleven Labs設定（Eleven Labsを選択した場合）
ELEVEN_LABS_API_KEY=[your-api-key]
ELEVEN_LABS_MODEL_ID=eleven_flash_v2_5

# RIME設定（RIMEを選択した場合）
RIME_API_KEY=[your-api-key]
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digitalhumans.jp/dev/miniprem/miniprem-install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.