MATIH Platform is in active MVP development. Documentation reflects current implementation status.
5. Quickstart Tutorials
Overview

Chapter 5: Quickstart Tutorials

This chapter provides hands-on tutorials that walk you through the core capabilities of the MATIH Platform. Each tutorial is self-contained and can be completed in 15 to 30 minutes. By the end of this chapter, you will have experience with natural language querying, dashboard building, model training, data quality exploration, and platform administration.


Prerequisites

Before starting these tutorials, ensure you have:

  1. A running MATIH instance -- either local (see Local Development Setup) or cloud-deployed (see Cloud Deployment)
  2. First-time configuration completed -- an admin user, a tenant, and at least one data source (see First-Time Configuration)
  3. A web browser -- Chrome, Firefox, or Edge (latest versions)

Tutorial Overview

TutorialWorkbenchTimeWhat You Will Learn
Your First Natural Language QueryAgentic Workbench15 minAsk questions in plain English and get SQL results
Building a DashboardBI Workbench20 minCreate visualizations and arrange them in a dashboard
Training a ModelML Workbench25 minTrain, evaluate, and register a machine learning model
Data Quality ExplorationData Workbench20 minProfile data, detect anomalies, and set quality rules
Platform AdministrationControl Plane UI20 minManage tenants, users, roles, and monitor the platform

Sample Data

The tutorials use a sample retail analytics dataset that is included with the platform. The dataset contains:

TableRowsDescription
orders50,000Customer orders with timestamps, amounts, and status
customers5,000Customer profiles with demographics and segments
products500Product catalog with categories and pricing
inventory2,000Current inventory levels by warehouse
returns3,500Product returns with reasons and resolution

This dataset is automatically loaded when you create a tenant with the sample data option enabled, or you can load it manually through the Data Workbench.


Tutorial Flow

The tutorials are designed to be completed in order, with each one building on concepts from the previous:

[1. Natural Language Query] -- Learn conversational analytics
        |
        v
[2. Building a Dashboard] -- Visualize query results
        |
        v
[3. Training a Model] -- Predict outcomes from data
        |
        v
[4. Data Quality] -- Ensure data reliability
        |
        v
[5. Platform Admin] -- Manage the platform

However, each tutorial can also be completed independently if you are only interested in a specific capability.


Accessing the Workbenches

Local Development

WorkbenchURL
Agentic Workbenchhttp://localhost:3003
BI Workbenchhttp://localhost:3000
ML Workbenchhttp://localhost:3001
Data Workbenchhttp://localhost:3002
Control Plane UIhttp://localhost:3004

Cloud Deployment

WorkbenchURL Pattern
Agentic Workbenchhttps://agentic.{tenant}.matih.ai
BI Workbenchhttps://bi.{tenant}.matih.ai
ML Workbenchhttps://ml.{tenant}.matih.ai
Data Workbenchhttps://data.{tenant}.matih.ai
Control Plane UIhttps://admin.matih.ai

Getting Help

If you encounter issues during the tutorials:

  • Check the Verification page for troubleshooting guidance
  • Review service logs in the relevant workbench's developer console
  • Use the platform status script: ./scripts/tools/platform-status.sh

Begin with Your First Natural Language Query.