メインコンテンツまでスキップ

CLI

chatwalaau コマンドはサーバを起動し、稼働中インスタンスのクライアントとしても動作 します。

サーバコマンド​

chatwalaau                                サーバを起動
chatwalaau init                           テンプレートから .env を生成
chatwalaau init --force                   既存の .env を上書き
chatwalaau init --no-model                .env を生成し、モデル設定ステップを省略
chatwalaau env diff                       同梱テンプレートとの .env 差分を報告
chatwalaau env sync                        .env をテンプレートへ再生成（ドライラン）
chatwalaau env sync --write               適用（先にタイムスタンプ付きバックアップ）
chatwalaau hash-password                  AUTH_PASSWORD_HASH を生成（対話）
chatwalaau hash-password --stdin --quiet  標準入力からハッシュ生成（スクリプト）
chatwalaau --host 0.0.0.0                 すべてのインターフェースにバインド
chatwalaau --port 9000                    カスタムポート
chatwalaau --skip-auth-check              Azure CLI ログインチェックを省略
chatwalaau --ssl-certfile cert.pem \
           --ssl-keyfile key.pem          HTTPS を有効化（LAN アクセス）
chatwalaau --version                      バージョン表示

クライアントコマンド​

稼働中インスタンスをコマンドラインから操作します。すべてのクライアントコマンドは 機械可読出力の --json と、リモートサーバ用の --base-url / --api-key に対応します。

# エージェントとチャット（単発）
chatwalaau chat "What is the weather in Tokyo?"

# 対話チャット（REPL）
chatwalaau chat -i

# モデルとセッションを指定
chatwalaau chat "hello" -m gpt-4o -s <session-id>

# セッション（ピン留めが先頭、その後は最終更新が新しい順）
chatwalaau sessions list
chatwalaau sessions get <id> --messages
chatwalaau sessions delete <id>
chatwalaau sessions export <id> -o backup.json

# テンプレート
chatwalaau templates list
chatwalaau templates create -n "Bug Report" -c "Describe the bug..."

# モデル
chatwalaau models list                   # 稼働中サーバのモデルを一覧（読み取り専用）
chatwalaau models add                    # 対話ウィザード: offering を作成して追記
chatwalaau models edit <id>              # ローカルカタログ内の offering を編集
chatwalaau models remove <id>            # ローカルカタログから offering を削除
chatwalaau models role list              # タスク別モデルの役割と割り当てを一覧
chatwalaau models role set <role> <id>   # タスクにチャット offering を割り当て（例: session_title）
chatwalaau models role clear <role>      # タスクを解除（セッション/既定モデルに戻す）

# 読み上げ（TTS）
chatwalaau tts "Hello world" -o greeting.mp3

# ファイルアップロード
chatwalaau upload document.pdf -s <session-id>

# スクリプト / エージェント間連携向けの JSON 出力
chatwalaau sessions list --json | jq '.[].thread_id'

# HTTPS リモートサーバ（自己署名証明書）
chatwalaau sessions list --base-url https://192.168.1.10:8000 --no-verify

chatwalaau models add / edit / remove はオフラインで動作します -- ローカルの モデルオファリングカタログファイル（MODEL_OFFERINGS_FILE、既定 model_offerings.jsonc）を作成・編集し、稼働中サーバは不要です。稼働中インスタンスに 問い合わせるのは models list のみです。ウィザードが尋ねるのは API キーの環境変数の 名前であり、秘密の値ではありません。 モデルと推論 -> モデルオファリングカタログ を参照。

chatwalaau upload は送信前にファイルを検証します。存在すること、サニタイズ後の ファイル名が有効であること、MIME タイプが対応画像形式か PDF であること、サイズが 画像 20MB / PDF 50MB 以内であること。

クライアント設定​

CHATWALAAU_URL=http://localhost:8000     # 既定のサーバ URL
CHATWALAAU_API_KEY=sk-your-key           # Bearer トークン（未設定なら API_KEY を再利用）