Skip to main content
MindsDB releases new features, functionalitites, and fixes on regular cadence. This document outlines the release process, versioning, and naming conventions.

Release Types and Versioning

MindsDB uses semantic versioning to name all releases. This format is applied consistently across our GitHub tags, Python packages, and Docker images. Each release name follows the structure:
v<MAJOR>.<MINOR>.<PATCH>(<TYPE><NUMBER>)
Where:
  • MAJOR indicates the major version, which introduces significant changes or backward-incompatible updates.
  • MINOR indicates the minor version, which introduces new features that remain backward-compatible.
  • PATCH indicates the patch version, which introduces small fixes or improvements.
  • TYPE is an optional component, which informs about the nature of the (pre-)release.
  • NUMBER is an optional component used when TYPE is provided that indicates the pre-release version.
The following are the release types and their naming conventions.
Release TypeSample VersionDescription
GA (General Availability)v25.9.3The stable public release. 25 is the major version, 9 is the minor version, and 3 is the patch number.
Pre-GA (Release Candidate)v25.9.3rc1A release candidate that is nearly ready for GA. rc stands for release candidate, and 1 indicates the version number of the pre-release.
Alphav25.9.3alpha1An early testing version with limited features or stability. alpha denotes an initial stage for internal or early feedback.
Betav25.9.3beta1A version close to final release. beta indicates a feature-complete build shared for broader testing and feedback.

Release Process

The main branch of the MindsDB repository contains the latest stable version of MindsDB and represents the GA (General Availability) release. MindsDB follows the Gitflow branching model to manage development and releases as follows.
1

Development Phase

All code changes are first committed to the develop branch.
2

Release Preparation

When a release is approaching, a short-lived release branch is created from the develop branch.
  • This branch is used for final testing and validation.
  • Pre-GA artifacts are built at this stage, including both the Python package and the Docker image, and shared for broader testing and feedback.
3

Release Finalization

After successful testing and validation:
  • The release branch is merged into the main branch, making it an official GA release.
  • The final GA versions of the Python package and Docker image are released, while the pre-GA version are removed.
If you are interested in contributing to MindsDB, follow this link.
I