Dome Systems
Dashboard
DocsLearnHands-on LabsTemplatesHelpChangelogCLIAPIMCPSDKs

Hello Dome

A minimal, runnable chat template for verifying Dome Template Registry publishing.

User
Caller
  • chat
App
Agent
  • hello-dome
Governance
Gateway
  • hello-dome
Pool

hello-dome-pool

  • hello-model

What this template gives you

  • Interface

    A chat window, in your browser

    Use the included interface to send a request to this template.

  • Gateway

    hello-dome gateway

    This template sends its requests through hello-dome gateway, where its access rules and limits apply.

  • Model

    hello-model

    This template uses hello-model through the hello-dome-pool pool.

Usage

Hand this template to an AI agent to set up this template

Node.js and npm to run npx.

Dome CLI, installed with brew install dome-systems/tap/dome, then signed in with dome auth login.

Docker Compose to run the companion app locally.

  1. 1

    Create a sandbox workspace

    dome sandbox provision --scope workspace

    Use a sandbox while trying a template. Provisioning does not switch your active context.

  2. 2

    Switch to the sandbox workspace

    dome context sync
dome context list
dome context use sandbox-<sandbox-name>

    Replace <sandbox-name> with the sandbox name returned when provisioning it.

  3. 3

    Pull the template

    npx @domesystems/templates pull im2nguyen/hello-dome@0.1.1 --dir hello-dome

    Downloads this immutable release and verifies its digest.

  4. 4

    Run the template

    npx @domesystems/templates up --dir hello-dome

    Imports it into Dome and starts the companion app.

Dome import variables

npx @domesystems/templates up imports the template into Dome and prompts for required values. For unattended runs, set them as DOME_IMPORT_VAR_… environment variables.

Required values

  • DOME_IMPORT_VAR_anthropic_api_key

Runtime environment

These variables are required to run the agent. During pull, .env.example is copied to .env when available. If they’re missing, npx @domesystems/templates up retrieves them from Dome and saves them in .env. Pass --provision to refresh them.

# Required for live mode. Supply these after `dome import dome.tf` and
# `dome import outputs <job-id>`. They are deliberately ignored by Git.
DOME_TOKEN=
DOME_GATEWAY_URL=

Agent instructions

You are Hello Dome, a concise and helpful assistant who speaks with a warm,
natural Irish English voice. Use Irish phrasing and expressions sparingly and
authentically, while keeping every response clear and easy to understand.

Answer the user directly. If a request needs external data or an action you
cannot perform, say so plainly instead of inventing a result.