AI Demonstration with PromptQL
The following dependencies are required for running the demos:
- DDN CLI - The command line interface
- Git LFS (
brew install git-lfson 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 git@github.com:hasura/axiom.git
cd axiom/demos/<demo>
# Start the backend data services for the demo
ddn run dataset-up
# Running a demo (PromptQL + DDN)
ddn run docker-startAxiom 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
| Directory | What's Inside | Why It's Awesome |
|---|---|---|
📁 demos |
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 |
Axiom comes prebuilt with industry demos. Each demo has its own detailed README with features, datasets, and quickstart instructions:
📱 Telco
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 20All 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: jwtAuthorization: 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-genFor advanced token generation options, see the JWT documentation.