インストール
ChatWalaʻau は PyPI で配布され、Python 3.12 以上で動作します。
Windows では、Python を同梱しコマンド操作が不要な ChatWalaʻau Desktop を インストールすることもできます。デスクトップアプリ (Windows) を参照してください。
クイックスタート
pip install chatwalaau
chatwalaau init
# .env を編集し、プロバイダーと認証方法を選択（下記参照）
chatwalaau
ブラウザで http://localhost:8000/chat を開きます。
ChatWalaʻau は Azure OpenAI と Anthropic (Claude) のどちらでも（または両方） 利用できます。最も簡単なのは API キー（Azure CLI もテナントも不要）です:
# API キーを使う Azure OpenAI
AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com/
AZURE_OPENAI_API_KEY=<your-key>
AZURE_OPENAI_MODELS=gpt-4o
# ...または Anthropic (Claude) を API キーで。Azure は一切不要
ANTHROPIC_MODELS=claude-sonnet-4-5-20250929
ANTHROPIC_API_KEY=sk-ant-...
Azure で Microsoft Entra ID を使いたい場合は、Azure CLI レーン（az login）、
マネージド ID、自動判別を利用できます。
設定 -> 認証 を参照してください。
| コマンド | 役割 |
|---|---|
chatwalaau init | .env テンプレートを生成（--force で上書き）。 |
chatwalaau | サーバを起動（Azure CLI 事前チェックは cli レーンのときだけ実行）。 |
必要要件
- Python 3.12 以上
- モデルプロバイダ -- Azure OpenAI または Anthropic Claude（両方可。デモ モードを使う場合は不要）
- Azure を
cliレーンの Entra ID で認証する場合のみ Azure CLI（az login）が 必要です。API キー / マネージド ID レーンに CLI は不要 -- 設定 -> 認証を参照。
社内ネットワーク（TLS 傍受プロキシ）
社内ルート CA で通信を再署名するプロキシ（Zscaler, Netskope, オンプレ機器）配下
では、最初の外向き HTTPS 通信が CERTIFICATE_VERIFY_FAILED で失敗することが
あります。OS の証明書ストアを信頼させるために任意の corp extras を入れます:
pip install "chatwalaau[corp]"
これは pip-system-certs を追加します（通常のインストールには影響なし）。あるいは
明示的な CA バンドルを指定します:
export SSL_CERT_FILE=/path/to/corp-root-ca.pem
export REQUESTS_CA_BUNDLE=/path/to/corp-root-ca.pem
アップグレード
pip install -U chatwalaau
chatwalaau env diff # あなたの .env に不足している新設定を確認
env diff / env sync は
設定 -> リリース間で .env を最新に保つ
を参照してください。
v0.197.0 以降へのアップグレードは一方向です。元に戻す可能性がある場合は、先にデータフォルダ
（.sessions/、.usage/）をバックアップしてください。v0.197.0 を一度実行したら、古いバージョンを
上から入れ直さないでください。また、古いバージョンと新しいバージョンを同じフォルダに対して同時に
動かさないでください。アップグレードそのものによって既存のチャットが影響を受けることはありません。
v0.219.0 から、ChatWalaau は Microsoft Agent Framework のうち使うパッケージだけをインストールします（263 から 149
パッケージに減ります）。アップグレードしても、不要になったパッケージは消えません。少ない構成にするには、新しい仮想環境に
入れ直すのがいちばん確実です。同じ環境で自分のコードから消えたパッケージ（boto3 や google-genai など）を import
している場合は、自分でインストールしてください。