Skip to main content
Version: 0.14.13

How to install Great Expectations locally

This guide will help you Install Great Expectations locally for use with Python.

note
  • Great Expectations is developed and tested on macOS and Linux Ubuntu. Installation for Windows users may vary from the steps listed below. If you have questions, feel free to reach out to the community on our Slack channel.
  • If you have the Mac M1, you may need to follow the instructions in this blog post: Installing Great Expectations on a Mac M1.

Steps​

Prerequisites
  • Great Expectations requires Python 3. For details on how to download and install Python on your platform, see python.org.

1. Check Python version​

First, check that you have Python 3 installed. You can check your version of Python by running:

python --version

If this command returns something other than a Python 3 version number (like Python 3.X.X), you may need to try this:

python3 --version

2. Install Great Expectations​

You can use either pip or Anaconda to install Great Expectations.

Once you have confirmed that Python 3 is installed locally, you can create a virutal environment with venv.

Python Virtual Environments
We have chosen to use venv for virtual environments in this guide, because it is included with Python 3. You are not limited to using venv, and can just as easily install Great Expectations into virtual environments with tools such as virtualenv, pyenv, etc.

Depending on whether you found that you needed to run python or python3 in the previous step, you will run either:

python -m venv venv

or

python3 -m venv venv

This command will create a new directory called venv where your virtual environment is located. In order to activate the virtual environment run:

source venv/bin/activate

Finally, you can ensure the latest version of pip is installed, and install Great Expectations, by running the appropriate pair of python commands below:

python -m ensurepip --upgrade
python -m pip install great_expectations

or

python3 -m ensurepip --upgrade
python3 -m pip install great_expectations

You can confirm that great_expectations was successfully installed with:

great_expectations --version

πŸš€πŸš€ Congratulations! πŸš€πŸš€ You successfully installed Great Expectations.