Skip to main content

Installation

ChatWalaʻau is distributed on PyPI and runs on Python 3.12+.

Quick start​

pip install chatwalaau
chatwalaau init
# Edit .env and set AZURE_OPENAI_ENDPOINT (see Configuration)
az login
chatwalaau

Then open http://localhost:8000/chat.

CommandWhat it does
chatwalaau initGenerate a .env template (--force overwrites).
chatwalaauStart the server (with an Azure CLI login pre-check).

Requirements​

  • Python 3.12+
  • A model provider -- Azure OpenAI (default) or Anthropic Claude -- unless you run in demo mode
  • For the default credential lane: the Azure CLI (az login). Other lanes (API key, managed identity) are described in Configuration.

Corporate networks (TLS-intercepting proxy)​

Behind a proxy that re-signs traffic with an in-house root CA (Zscaler, Netskope, on-prem middlebox), the first outbound HTTPS call can fail with CERTIFICATE_VERIFY_FAILED. Install the opt-in corp extras so Python trusts the OS certificate store:

pip install "chatwalaau[corp]"

This adds pip-system-certs; default installs are unaffected. Alternatively point Python at an explicit CA bundle:

export SSL_CERT_FILE=/path/to/corp-root-ca.pem
export REQUESTS_CA_BUNDLE=/path/to/corp-root-ca.pem

Upgrading​

pip install -U chatwalaau
chatwalaau env diff   # see which new settings your .env is missing

See Configuration -> Keeping .env current for env diff / env sync.

Next steps​

  • Configuration -- required settings and credential lanes.
  • Features -- what you can do once it is running.