Skip to content

Forecasting Quarterly House Sales with MindsDB


In this tutorial, we'll create, train, and query a machine learning model, which, in MindsDB language, is an AI Table or a predictor. We aim to predict sales forecasts for houses using a multivariate time series strategy.

Make sure you have access to a working MindsDB installation either locally or via

You can learn how to set up your account at MindsDB Cloud by following this guide. Another way is to set up MindsDB locally using Docker or Python.

Let's get started.

The Data

Connecting the data

There are a couple of ways you can get the data to follow through with this tutorial.

You can connect to a demo database that we've prepared for you. It contains the data used throughout this tutorial which is the example_db.demo_data.house_sales table.

    WITH ENGINE = "postgres",
        "user": "demo_user",
        "password": "demo_password",
        "host": "",
        "port": "5432",
        "database": "demo"

Now you can run queries directly on the demo database. Let's preview the data that we'll use to train our predictor.

FROM example_db.demo_data.house_sales 

The dataset we use in this tutorial is the pre-processed version of the House Property Sales data. You can download it from Kaggle. We use the ma_lga_12345.csv file.

And this guide explains how to upload a file to MindsDB.

Now, you can query the uploaded file as if it were a table.

FROM files.house_sales

From now on, we will use the files.house_sales file as a table. Make sure you replace it with example_db.demo_data.house_sales if you use the demo database.

Understanding the Data

We will use the house sales dataset where each row represents one real estate (house or unit). It tracks quarterly moving averages of house sales aggregated by type and amount of bedrooms in each listing. These quarterly moving averages will be predicted in the following sections of this tutorial.

Below is the sample data stored in the house sales dataset.

|saledate  |MA    |type |bedrooms|
|30/09/2007|441854|house|2       |
|31/12/2007|441854|house|2       |
|31/03/2008|441854|house|2       |
|30/06/2016|430880|unit |2       |
|30/09/2016|430654|unit |2       |


Column Description Data Type Usage
saledate The date of sale date Feature
MA Moving average of the historical median price of the house or unit integer Label
type Type of property (either a house or a unit) character varying Feature
bedrooms Number of bedrooms integer Feature

Labels and Features

A label is the thing we're predicting — the y variable in simple linear regression. A feature is an input variable — the x variable in simple linear regression.

Training a Predictor Via CREATE PREDICTOR

Let's create and train your first machine learning predictor. For that, we are going to use the CREATE PREDICTOR syntax where we specify what sub-query to train FROM (features) and what we want to PREDICT (labels).

CREATE PREDICTOR mindsdb.house_sales_predictor
FROM files
  (SELECT * FROM house_sales)
ORDER BY saledate
GROUP BY bedrooms, type
-- as the target is quarterly,
-- we will look back two years to forecast the next one

We use all of the columns as features, except for the MA column whose value is going to be predicted.

MindsDB makes it simple so that we don't need to repeat the predictor creation process for every group, that is, for every number of bedrooms or for every type of a real estate. Instead, we just group by both the bedrooms and type columns and the predictor learns from all series and enables forecasts for all of them!

Checking the Status of a Predictor

A predictor may take a couple of minutes for the training to complete. You can monitor the status of your predictor by using this SQL command:

SELECT status
FROM mindsdb.predictors
WHERE name='house_sales_predictor';

If we run it right after creating a predictor, we'll most probably get this output:

| status   |
| training |

But if we wait a couple of minutes, this should be the output:

| status   |
| complete |

Now, if the status of our predictor says complete, we can start making predictions!

Making Predictions

You can make predictions by querying the predictor as if it were a table. The SELECT syntax lets you make predictions for the label based on the chosen features for a given period of time. Usually, you want to know what happens right after the latest training data point that was fed. We have a special keyword for that: the LATEST keyword.

SELECT m.saledate AS date, m.MA AS forecast
FROM mindsdb.house_sales_predictor AS m 
JOIN files.house_sales AS t
WHERE t.saledate > LATEST 
AND t.type = 'house' 
AND t.bedrooms = 2

Now, try changing the type column value to unit, or the bedrooms column value to any number between 1 to 5, and check how the forecasts vary. This is because MindsDB recognizes each grouping as being its own different time series.

What's Next?

Have fun while trying it out yourself!

If this tutorial was helpful, please give us a GitHub star here.