本手順書では、以下の2つのパッケージを使用して、Flow LiteとArcFactを導入する手順を説明します。

導入順序は必ず以下の順番で実施してください。

A → B 

本書では、Krugle Squad(ArcFact)とFlow Liteを同一のGPU搭載ホスト上に導入するシナリオに沿って記載します。
既に導入済みで稼働中のFlow Liteサービスを利用する場合は、手順中の指示に従ってください。

以下の3つのパッケージが、あらかじめ導入対象サーバー上に配置されていることを確認してください。

https://downloads.krugle.org/.archaea/
　flow-lite-gpu-*.tar.gz
　krugle-squad-*.tar.gz
　
　checkpoints.tgz [Option]

また、HTTPS通信用の証明書ファイルを準備してください。

例：自己証明書の場合

openssl req -newkey rsa:4096 -nodes -sha256 -keyout server.key -x509 -days 3650 -out server.crt

以降の手順では例として以下のファイル名を使用します。

server.crt
server.key

Flow LiteをArcFact(Squad)と同一のGPUホスト上に導入します。

####　別サーバ上で既に稼働中のFlow Liteを使用する場合はこの手順3をスキップしてください。

tar -xzf flow-lite-gpu-*.tar.gz
cd flow-lite-gpu

sudo ./install.sh

インストール中に表示されるプロンプトに従って、以下の内容を入力します。

• 出力言語
• マルチモーダルモデル名
• マルチモーダルモデル用のAPIキー

このステップは、デフォルトの日本語パーサーLinguastarに替えてIngestarを使用する場合にのみ必要ですので、通常はスキップしてください。

tar -xzf checkpoints.tgz -C /opt/flow-lite/

sudo systemctl start flow-lite

Flow Lite のみライセンス登録が必要です。

まず、フィンガープリントファイルを作成します。

cd /opt/flow-lite
sudo ./fingerprint.sh > fingerprint.txt

作成された fingerprint.txt をKrugle担当者へご送付ください。

ライセンスファイルarchaea.licを受領したら、以下の場所に保存します。

/opt/flow-lite/archaea.lic

ライセンスファイル配置後、Flow Lite を再起動します。

sudo systemctl restart flow-lite

Krugle Squad (ArcFact) を導入します。

tar -xzf krugle-squad-*.tar.gz
cd krugle-squad

sudo ./install.sh

インストール中に表示されるプロンプトに従って、以下の内容を入力します。

• LLM APIキー
• LLM API URL
• 利用するLLMモデル名
• Flow Lite URL [同一ホスト上の場合は http://flow-lite:8000]

Squad Web UI 用のSSL証明書を配置します。

sudo cp server.crt server.key /opt/arcfact/ssl/

sudo vi /opt/arcfact/.env

• エージェントがプロンプトで使用する言語を日本語化

PROMPT_LANGUAGE=jp ##デフォルトはenになっている箇所をjpに変更してください

• 暗号化キー設定を無効化

#RECIPE_ENCRYPTION_KEY=

• HTTPSサーバ設定の追記

ALLOW_INSECURE_DEFAULTS=true

Krugle Squad (ArcFact) を起動します。

sudo systemctl start arcfact

導入完了後、ブラウザから以下のURLにアクセスします。 <host> には、Combo Gateway を導入したサーバーのホスト名またはIPアドレスを指定してください。

https://<host>/

• 初回のログインには今すぐ登録から招待コード を使用したアカウント登録が必要です。
• 招待コードは/opt/arcfact/.env 中のINVITATION_CODEで設定してください。(default:ano94great) 　　

例：ArcFact を再起動する場合

sudo systemctl restart arcfact

例：ArcFact の状態を確認する場合

sudo systemctl status arcfact

一般的な操作は以下の形式で実行します。

sudo systemctl start <service-name>
sudo systemctl stop <service-name>
sudo systemctl restart <service-name>
sudo systemctl status <service-name>

Dockerコンテナの稼働状況を確認します。

docker ps
docker stats

例：manufact-api コンテナのログを確認する場合

docker logs -f manufact-api

製品の設定ファイルを変更した場合は、対象サービスを再起動します。

例：ArcFact の設定を変更する場合

sudo nano /opt/arcfact/.env
sudo systemctl restart arcfact

各サービスの起動、停止、再起動には、原則として systemctl を使用してください。

sudo systemctl restart arcfact

docker compose を直接使用して起動・停止することは推奨されません。

やむを得ず docker compose を手動で実行する場合は、必要な環境変数を読み込んだ上で実行してください。

例：ArcFact の compose 状態を確認する場合

cd /opt/arcfact
sudo bash -c 'set -a; . ./compose.env; docker compose ps'

以下のサービスは、サーバー再起動時に自動起動します。

flow-lite
arcfact

以下を確認してください。

• Flow Lite が起動していること
• Flow Lite のライセンスファイル /opt/flow-lite/archaea.lic が配置されていること
• Squad(ArcFact) のインストールが完了していること
• Squad(ArcFact) が起動していること
• https://<host>/ で ArcFact にアクセスできること
• docker ps で関連コンテナが起動していること

以上で、Krugle Squadの導入は完了です。