Hyperterse — Agentic server framework.

Cloud Run is the recommended way to deploy Hyperterse on GCP. It provides serverless containers with automatic scaling, built-in HTTPS, and pay-per-use pricing. Hyperterse runs as a standard container — no special adaptation needed.

Prerequisites

You need the gcloud CLI configured with a project that has the Cloud Run, Cloud Build, and Secret Manager APIs enabled:

gcloud config set project PROJECT_ID
gcloud services enable run.googleapis.com cloudbuild.googleapis.com secretmanager.googleapis.com

Deploy to Cloud Run

Build the artifact

hyperterse build -o dist

Build and push the container image

Use the Docker deployment patterns to create your Dockerfile. Then build and push to Google Container Registry:

docker build -t gcr.io/PROJECT_ID/hyperterse:latest .
docker push gcr.io/PROJECT_ID/hyperterse:latest

Alternatively, use Cloud Build:

gcloud builds submit --tag gcr.io/PROJECT_ID/hyperterse:latest

Store credentials in Secret Manager

echo -n "postgresql://user:pass@host:5432/db" | \
  gcloud secrets create hyperterse-db --data-file=-

Grant your Cloud Run service account access:

PROJECT_NUMBER=$(gcloud projects describe PROJECT_ID --format="value(projectNumber)")

gcloud secrets add-iam-policy-binding hyperterse-db \
  --member="serviceAccount:${PROJECT_NUMBER}-compute@developer.gserviceaccount.com" \
  --role="roles/secretmanager.secretAccessor"

Deploy

gcloud run deploy hyperterse \
  --image gcr.io/PROJECT_ID/hyperterse:latest \
  --platform managed \
  --region us-central1 \
  --port 8080 \
  --set-secrets DATABASE_URL=hyperterse-db:latest \
  --allow-unauthenticated \
  --memory 512Mi \
  --cpu 1

Get the service URL

gcloud run services describe hyperterse \
  --platform managed \
  --region us-central1 \
  --format="value(status.url)"

Cloud SQL integration

Connect to Cloud SQL for managed PostgreSQL or MySQL:

gcloud sql instances create hyperterse-db \
  --database-version=POSTGRES_14 \
  --tier=db-f1-micro \
  --region=us-central1

gcloud run services update hyperterse \
  --add-cloudsql-instances PROJECT_ID:us-central1:hyperterse-db \
  --region us-central1

Use a Unix socket connection string for Cloud SQL:

postgresql://user:password@/dbname?host=/cloudsql/PROJECT_ID:us-central1:hyperterse-db

Scaling

Cloud Run scales automatically based on incoming requests. Configure minimum and maximum instances:

gcloud run services update hyperterse \
  --min-instances=1 \
  --max-instances=10 \
  --region us-central1

Setting min-instances=1 avoids cold starts at the cost of continuous billing.

GKE alternative

For Kubernetes-based deployments on GCP, create a GKE cluster and follow the Kubernetes deployment guide:

gcloud container clusters create hyperterse-cluster \
  --num-nodes=3 \
  --region=us-central1

Getting started

Foundation

Agents

Tools

Resources

Prompts

Runtime

Databases

Deployment

Security

Google Cloud

Prerequisites

Deploy to Cloud Run

Cloud SQL integration

Scaling

GKE alternative

​Prerequisites

​Deploy to Cloud Run

​Cloud SQL integration

​Scaling

​GKE alternative

Prerequisites

Deploy to Cloud Run

Cloud SQL integration

Scaling

GKE alternative