💚 Axiom: Hasura Industry Demo Toolkit

API and AI Demonstration with Hasura DDN and PromptQL

🧰 Prerequisites

The following dependencies are required for running the demos:

• DDN CLI - The Hasura 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

Optional:

• Ansible - Only needed for internal presales team infrastructure management

🏁 Quick Start

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

cd axiom/hasura

# Init is only required once for each demo profile
ddn run init -- telco

# Running a demo (telco, aml, healthcare)
ddn run demo -- telco

🔍 Overview

Axiom brings Hasura'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

Directory	What's Inside	Why It's Awesome
📁 hasura	DDN configurations, supergraphs, subgraphs, and connector metadata	The heart of each demo - where DDN metadata resides
📁 scripts	Utility tools and helper scripts	Makes deployment and management simple
📁 .data	Seed data and Docker configurations	Pre-configured data to make demos work out of the box
📁 infra	Ansible playbooks (optional)	For internal presales team infrastructure management

🌟 Demo Profiles

Axiom comes prebuilt with industry demos:

📱 Telco

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

💰 AML (Anti-Money Laundering)

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

🏥 Healthcare

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

🛒 CPG (Consumer Packaged Goods)

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

📊 GTM (Go-to-Market)

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

🔍 Due Diligence

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

👶 Starter

A simplified example to act as a starter kit for new demo use cases.

📱 Telco Demo in Action

Features

• Customer 360° View - Customer management and billing
• Network Operations Center - Real-time monitoring and analytics
• Service Activation - Provisioning and activation workflows
• Identity Management - Authentication and authorisation

Quick Start

cd hasura

# Setting up the environment
ddn run init -- telco

# Launching the demo
ddn run demo -- telco

💰 AML Demo in Action

Features

• Risk Scoring - Real-time customer risk assessment and KYC validation
• Sanctions Screening - Automated sanctions flagging
• Smart Monitoring - AI detection of suspicious patterns
• Compliance Workflows - SAR management and account freezing

Quick Start

cd hasura

# Setting up the environment
ddn run init -- aml

# Launching the demo
ddn run demo -- aml

🏥 Healthcare Demo in Action

Features

• Patient Ops - Patient management and care coordination
• Smart Scheduling - Operator scheduling and availability management
• Case Prioritisation - Case management with urgency tracking
• Medical Reference - Drug and procedure reference data
• Emergency Response - Emergency slot management system

Quick Start

cd hasura

# Setting up the environment
ddn run init -- healthcare

# Launching the demo
ddn run demo -- healthcare

🛒 CPG Demo in Action

Features

• Product Management - Comprehensive product catalog and category management
• Retail Operations - Inventory tracking, assortment planning, and availability monitoring
• Promotional Planning - Campaign creation, discount management, and promotional effectiveness
• Market Analytics - Sales tracking, market share analysis, and competitive intelligence
• Retail Execution - Store-level merchandising, pricing updates, and inventory allocation

Quick Start

cd hasura

# Setting up the environment
ddn run init -- cpg

# Launching the demo
ddn run demo -- cpg

🔍 Due Diligence Demo in Action

Features

• Financial Analysis - Comprehensive financial statement analysis and validation
• Valuation Operations - Scenario modeling and adjustment calculations
• Inconsistency Detection - Automated flagging of financial inconsistencies
• ERP Integration - Complete access to enterprise resource planning data
• Finding Management - Creation and tracking of due diligence findings

Quick Start

cd hasura

# Setting up the environment
ddn run init -- diligence

# Launching the demo
ddn run demo -- diligence

📊 GTM Demo in Action

Features

• Sales Operations - Opportunity management, forecasting, and pipeline analytics
• Marketing Automation - Campaign management, lead nurturing, and sequence creation
• Revenue Intelligence - Call analytics, opportunity insights, and revenue forecasting
• Account Management - Customer 360° view with integrated contact and account data
• Sales Enablement - Content management, call transcriptions, and action items

Quick Start

cd hasura

# Setting up the environment
ddn run init -- gtm

# Launching the demo
ddn run demo -- gtm

🛠️ Command Reference

Command	What it Does	When to Use It
ddn run init -- <context>	🛠️ Initializes the DDN environment	Run this once before using other commands or when setting up a new demo
ddn run build -- <context>	🏗️ Builds the DDN supergraph	When you've made metadata changes
ddn run docker-start -- <context>	🐳 Starts the Docker containers	When you need the data sources
ddn run demo -- <context>	✨ Does build, docker-start, and starts Hasura/PromptQL	The all-in-one command to get started
ddn run docker-stop	🛑 Stops all containers	When you're done or need to switch demos

> [!TIP]
> The `ddn run init` & `ddn run demo` commands provide the fastest path to a running demo.


## 🌟 Deployment & Management

Demos may be pushed to Hasura Cloud with simple/configurable deployment tools

### Deploying Metadata Changes

Changes are released in seconds with _deploy_. Full documentation in the [deploy README](./scripts/deploy/README.md).

```bash
# Deploying changes to the cloud
./scripts/deploy/deploy.mjs --context telco-dev --profile telco

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

Managing Connectors

Deploying New Connectors

After updating connector configuration or schema, the deploy script should be used with the --rebuild-connectors flag:

# Deploying updated connectors
node ./scripts/deploy/deploy.mjs --context telco-dev --profile telco --rebuild-connectors

Cleaning Up Old Connectors

The connector cleanup tool helps maintain a tidy cloud environment:

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

Caution

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

🎉 Building Custom Demos

The hasura/README.md provides detailed instructions on adding new industry demos to the toolkit.