Hyperterse — Agentic server framework.

Azure Container Apps is the recommended way to deploy Hyperterse on Azure. It provides a fully managed serverless container platform with automatic scaling, built-in HTTPS, and integration with Azure services.

Prerequisites

You need the Azure CLI configured with an active subscription. Install the Container Apps extension:

az extension add --name containerapp --upgrade
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights

Deploy to Container Apps

Build the artifact

hyperterse build -o dist

Create a resource group and container registry

az group create --name hyperterse-rg --location eastus

az acr create --name hyperterseregistry --resource-group hyperterse-rg --sku Basic
az acr login --name hyperterseregistry

Build and push the container image

Use the Docker deployment patterns to create your Dockerfile. Then push to Azure Container Registry:

docker build -t hyperterseregistry.azurecr.io/hyperterse:latest .
docker push hyperterseregistry.azurecr.io/hyperterse:latest

Create the Container Apps environment

az containerapp env create \
  --name hyperterse-env \
  --resource-group hyperterse-rg \
  --location eastus

Deploy

az containerapp create \
  --name hyperterse \
  --resource-group hyperterse-rg \
  --environment hyperterse-env \
  --image hyperterseregistry.azurecr.io/hyperterse:latest \
  --registry-server hyperterseregistry.azurecr.io \
  --target-port 8080 \
  --ingress external \
  --min-replicas 1 \
  --max-replicas 10 \
  --secrets "db-url=postgresql://user:pass@host:5432/db" \
  --env-vars "DATABASE_URL=secretref:db-url"

Azure Database for PostgreSQL

Connect to a managed PostgreSQL instance:

az postgres flexible-server create \
  --name hyperterse-db \
  --resource-group hyperterse-rg \
  --location eastus \
  --admin-user admin \
  --admin-password YourSecurePassword \
  --sku-name Standard_B1ms \
  --tier Burstable

Ensure the Container Apps environment and the database are on the same virtual network, or configure firewall rules to allow connectivity.

Key Vault integration

For production credentials, use Azure Key Vault instead of inline secrets:

az keyvault create --name hyperterse-kv --resource-group hyperterse-rg --location eastus
az keyvault secret set --vault-name hyperterse-kv --name database-url --value "postgresql://..."

Reference Key Vault secrets in your Container App configuration through managed identity.

AKS alternative

For Kubernetes-based deployments, create an AKS cluster and follow the Kubernetes deployment guide:

az aks create --name hyperterse-aks --resource-group hyperterse-rg --node-count 3
az aks get-credentials --name hyperterse-aks --resource-group hyperterse-rg

Getting started

Foundation

Agents

Tools

Resources

Prompts

Runtime

Databases

Deployment

Security

Azure

Prerequisites

Deploy to Container Apps

Azure Database for PostgreSQL

Key Vault integration

AKS alternative

​Prerequisites

​Deploy to Container Apps

​Azure Database for PostgreSQL

​Key Vault integration

​AKS alternative

Prerequisites

Deploy to Container Apps

Azure Database for PostgreSQL

Key Vault integration

AKS alternative