すべてのカテゴリ
開発・設置
操作ガイド

操作ガイド

概要

本ドキュメントでは、miniprem.shスクリプトを使用したMiniPremサービスの制御方法について説明します。

本スクリプトは Ubuntu 24.04 環境、または該当サーバーへ SSH で接続したターミナル上で実行することを前提としています。コマンドは、物理端末やリモート（SSH）接続したターミナルで操作してください。

操作できる条件

  • MiniPremのインストールが完了していること
  • miniprem.shスクリプトに実行権限があること
 

コマンド一覧

基本構文

./miniprem.sh [コマンド] [オプション]
 

利用可能なコマンド

コマンド
説明
使用例
start
MiniPremサービスを起動します
./miniprem.sh start
stop
MiniPremサービスを停止します
./miniprem.sh stop
restart
MiniPremサービスを再起動します
./miniprem.sh restart
status
サービスの稼働状況を確認します
./miniprem.sh status
logs
サービスのログをリアルタイムで表示します
./miniprem.sh logs
setup
Flowise chatflowの初期設定を実行します
./miniprem.sh setup
 

オプション

オプション
説明
-h, --help
ヘルプメッセージを表示します
 

詳細な使用方法

サービスの起動

./miniprem.sh start

このコマンドは以下の処理を実行します：

  • インストールタイプ（default/custom）に応じた適切なDocker Composeファイルを選択
  • 必要なDockerコンテナを起動
  • サービスの起動状況をログに出力
 

サービスの停止

実行中のすべてのMiniPremサービスを安全に停止します。

./miniprem.sh stop
 

サービスの再起動

サービスを一度停止してから再起動します。設定変更後などに使用します。

./miniprem.sh restart
 

ステータス確認

./miniprem.sh status
 

出力例：

+=================================================================+
| MiniPrem Services Status                                          |
+=================================================================+

NAME                      IMAGE                                                   COMMAND                  SERVICE                   CREATED             STATUS                 PORTS
audio2face_controller     facemeproduction/audio2face_anim_controller:local-dev   "./service/launch_se…"   audio2face_controller     7 hours ago         Up 7 hours (healthy)   0.0.0.0:52000->52000/tcp, :::52000->52000/tcp, 0.0.0.0:52100->52100/tcp, :::52100->52100/tcp
audio2face_with_emotion   facemeproduction/audio2face_with_emotion:local-dev      "/opt/nvidia/nvidia_…"   audio2face_with_emotion   7 hours ago         Up 7 hours (healthy)   0.0.0.0:50000->50000/tcp, :::50000->50000/tcp
renny                     facemeproduction/renny:0.540-40978                      "/opt/renny/entrypoi…"   renny                     7 hours ago         Up 7 hours (healthy)
 

ログの確認

./miniprem.sh logs

すべてのサービスのログをリアルタイムで表示します。Ctrl+Cで終了できます。

 

Flowise Chatflowのセットアップ

./miniprem.sh setup

このコマンドは以下の処理を実行します：

  1. Flowiseサービスの稼働確認
  1. サービスが停止している場合は自動的に起動
  1. Flowiseが完全に起動するまで待機（最大5分）
  1. Chatflowの初期設定スクリプトを実行
 

動作検証

1. コンテナの状態確認

MiniPrem関連のコンテナが正常に起動していることを確認します。

docker ps
 

2. サービスの動作確認

すべてのサービスが「Up」状態であることを確認します。

./miniprem.sh status
 

3. 動作テスト

実行中のセッション内で、デジタルヒューマンに対して発話指示を送信し、以下の機能が正常に動作することを確認します：

  • レンダリング - デジタルヒューマンが表示されるか
  • 音声合成 - TTSで音声が生成されるか
  • アニメーションやリップシンクしているか
  • 会話AI（オーケストレーションサービス）との接続ができて、会話ができるか
 

技術仕様

 

インストールタイプ

MiniPremは2つのインストールタイプをサポートしています：

  • default: 基本的な構成（docker/docker-compose.default.ymlを使用）
  • custom: カスタマイズされた構成（docker/docker-compose.ymlを使用）

インストールタイプは.miniprem_install_typeファイルに保存されます。

主要な環境変数はdocker/docker-compose.env ファイルに保存されます。

 

ディレクトリ構造

miniprem/
├── miniprem.sh          # メイン制御スクリプト
├── scripts/
│   ├── logging.sh       # ログ出力関数
│   └── docker.sh        # Docker操作関数
├── docker/
│   ├── docker-compose.yml
│   ├── docker-compose.default.yml
│   ├── docker-compose.env
│   └── setup-chatflow-post-deployment.sh
└── .miniprem_install_type
 

注意事項

  • スクリプトは必ずプロジェクトのルートディレクトリから実行してください
  • サービスの起動・停止には適切な権限が必要です
  • ログファイルは定期的に確認し、必要に応じてローテーションを行ってください
お役に立ちましたか？
😞
😐
🤩

最終更新日 June 25, 2025

インストール トラブルシュート