The following dependencies are required for running the demos:

• DDN CLI - The command line interface
• Git LFS (brew install git-lfs on macOS) - Required for handling large files
• Docker and Docker Compose - Necessary for running local environments
• Node.js - Needed for utility scripts
• jq - Required for utility scripts (brew install jq)

Optional:

• Ansible - Only needed for internal presales team infrastructure management

# Cloning the repository
git clone [email protected]:hasura/axiom.git

cd axiom/demos/<demo>

# Copy env vars to your demo data generator
cp .data/.env.template .data/<demo>/.env

# Start the backend data services for the demo
ddn run dataset-up

# Running a demo (PromptQL + DDN)
ddn run docker-start

Axiom brings PromptQL's capabilities to life through industry-specific demos:

• 🏭 Ready-to-run industry demos - Real-world industry use cases with minimal setup
• 🧪 Feature testing playground - New DDN & PromptQL features demonstrated in an example project
• 🛠️ Extensible toolkit - Easy to add new demos and customisations

Axiom comes prebuilt with industry demos. Each demo has its own detailed README with features, datasets, and quickstart instructions:

Telecommunications solutions with customer management, network operations, and service provisioning.

Compliance and risk management with real-time monitoring and automated flagging.

Patient operations platform with scheduling, case management, and medical reference data.

Retail operations and execution platform for CPG companies with product management, inventory allocation, and promotional planning.

Sales and marketing operations platform with opportunity management, campaign execution, and revenue forecasting.

Financial due diligence platform with valuation operations, financial analysis, and ERP data integration.

End-to-end supply chain management platform with manufacturing, logistics, and e-commerce integration.

Demos may be pushed to PromptQL Cloud with standard DDN CLI tooling.

Changes are released in seconds with DDN CLI.

cd demos/<demo>

# quick deploy (no message)
ddn supergraph build create

# better: include name and commit summary for traceability
# e.g. Adam Malone: c196a1e CI: Modify cpg (#189)
ddn supergraph build create --description "$(git config user.name): $(git log -1 --pretty=format:'%h %s')"

The script handles both JWT and No-Auth deployments automatically, making deployment easier.

The connector cleanup tool helps maintain a tidy cloud environment

[!CAUTION] >

Caution advised: This operation removes connectors from the cloud supergraph.

# Removing the 20 oldest connector builds
./scripts/connector-delete.sh telco-dev 20

All demos support multiple authentication modes configured in their auth-config.hml

Demos should be configured to allow data access for a non-privileged customer role with a predefined id for simplicity.

• No headers required
• Default admin role access

JWT mode can be achieved both in PromptQL and DDN by setting the following headers:

• X-Hasura-Auth-Mode: jwt
• Authorization: Bearer <token>

Default functionality creates a token with the following grants:

• x-hasura-role: customer
• x-hasura-user-id: 7

cd demos/<demo-name>
ddn run jwt-gen

For advanced token generation options, see the JWT documentation.