CLI

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

サーバコマンド

chatwalaau                                サーバを起動
chatwalaau init                           テンプレートから .env を生成
chatwalaau init --force                   既存の .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

# 読み上げ（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 upload は送信前にファイルを検証します。存在すること、サニタイズ後の ファイル名が有効であること、MIME タイプが対応画像形式か PDF であること、サイズが 画像 20MB / PDF 50MB 以内であること。

クライアント設定

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