polyclaw
Prerequisites
Required
These are needed regardless of which deployment target you choose.
| Dependency | Version | Purpose |
|---|---|---|
| Bun | latest | Runs the TUI (app/tui) |
| Docker | 20+ | Builds and runs the Polyclaw container |
Azure CLI (az) | 2.60+ | Infrastructure provisioning, Foundry authentication, Bicep deployments |
| Git | any | Cloning the repository |
The TUI installs its own Node dependencies automatically via bun install on first run.
Log in to Azure before launching the TUI:
az login
The container image includes Python, Node.js, the frontend build, and all runtime dependencies. You do not need to install them on your host machine.
Optional – Azure Container Apps Target
If you want to deploy to Azure instead of running locally, you also need:
| Dependency | Purpose |
|---|---|
| Azure subscription | Hosting the Container App and associated resources |
The TUI checks for az availability and login status automatically. If az is not found or you are not logged in, the ACA target is disabled in the picker with a descriptive message.
Optional – Extended Features
These are not required for basic operation but enable additional capabilities once polyclaw is running. Items marked auto-deployed are set up automatically during the initial deployment; the rest require manual configuration.
| Service / Tool | Required For | Deployed |
|---|---|---|
Cloudflare CLI (cloudflared) | Tunnel to expose bot endpoint | auto-deployed |
Playwright (npx playwright install chromium) | Browser automation MCP server | auto-deployed |
| Azure Bot Service | Telegram channel messaging | auto-deployed |
| Azure AI Services (Foundry) | LLM inference in BYOK mode | Bicep deploy |
| Azure Communication Services | Inbound and outbound voice calls | manual |
| Azure Key Vault | Centralized secret management | Bicep deploy |
| Azure Container Apps Dynamic Sessions | Sandboxed code execution | Bicep deploy |
| Azure AI Content Safety | Prompt Shields and content moderation | Bicep deploy |
| Azure OpenAI | Realtime voice model (gpt-4o-realtime) | manual |
These services are configured through the TUI setup screen or the web dashboard after initial deployment.
Verification
Open the admin web dashboard and navigate to the Preflight Check page. It validates all required and optional dependencies inside the running container and shows their status at a glance.