インストール
ChatWalaʻau は PyPI で配布され、Python 3.12 以上で動作します。
クイックスタート
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 を最新に保つ
を参照してください。