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

インストール

ChatWalaʻau は PyPI で配布され、Python 3.12 以上で動作します。

クイックスタート

pip install chatwalaau
chatwalaau init
# .env を編集し、プロバイダーと認証方法を選択(下記参照)
chatwalaau

ブラウザで http://localhost:8000/chat を開きます。

ChatWalaʻau は Azure OpenAIAnthropic (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 CLIaz 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 を最新に保つ を参照してください。

次のステップ

  • 設定 -- 必須設定と認証レーン。
  • 機能 -- 起動後にできること。