Installation

Pre-Requisites

Windows

Install Python

• Download the latest version of Python 3 from the official Python website.

Important: Check the options as seen below and click on Install Now

Post installation, Disable path length limit and then close.

• Verify the installation by running python --version on command prompt. It should show the current version.

---

Common Troubleshooting

• If Windows Store opens up the Python 3.13 page, then click on Get button.
• If you encounter the python is not recognized error, please refer to online resources for instructions on how to manually add Python to your PATH.

---

MacOS

Install Python (macOS usually ships with Python 2 by default).

brew install python

or

brew upgrade python

Verify

python3 --version

Install OpenSSL

brew install openssl

---

Linux

We support Ubuntu, Debian, and RHEL / CentOS distributions. (Alpine and SUSE support will come soon)

Install Python

On Ubuntu / Debian

sudo apt update
sudo apt install python3 python3-venv python3-pip

On RHEL / CentOS

sudo yum install python3 python3-venv python3-pip

On newer Fedora / RHEL systems

sudo dnf install python3 python3-venv python3-pip

Verify

python3 --version

---

NOTE: Minimum supported version required for Python is version 3.10.

---

Package Installation Steps

Install using pip

Steps (1) and (2) are optional for Windows and can be skipped.

1. Create a virtual environment

Open a terminal (cmd / PowerShell on Windows, Terminal on Mac/Linux), switch to your working directory and run: (replace python3 with python in case of error):

python3 -m venv myvenv

2. Activate the virtual environment:

OS	Command
Windows	myvenv\Scripts\activate
Mac/Linux	source myvenv/bin/activate

This should show a prefix (myvenv) in the command prompt.

3. Install mssql-python using pip install

pip install mssql-python