Installation

Estimated reading time: 6 minutes

Stable

The latest stable release of geovista is available on conda-forge and PyPI, and can be easily installed:

conda

$ conda create --name myenv --channel conda-forge geovista
$ conda activate myenv

Consult the conda Installation instructions.

pip

$ pip install geovista

Consult the pip Installation instructions.

pixi

$ pixi init myenv
$ cd myenv
$ pixi add geovista

Consult the pixi Installation instructions.

uv

$ uv pip install geovista

Consult the uv Installation instructions.

Additional package dependencies will be required by some of the geovista gallery Examples. If these are required then instead install the latest stable release as follows:

conda

$ conda create --name myenv --channel conda-forge geovista pip
$ conda activate myenv
$ pip install geovista[exam]

conda users must also install pip into their environment.

pip

$ pip install geovista[exam]

pixi

$ pixi init myenv
$ cd myenv
$ pixi add python
$ pixi add --pypi geovista[exam]

uv

$ uv pip install "geovista[exam]"

Latest

If you simply can’t wait for the next stable release of geovista, then install the latest development version from the main branch:

conda

$ conda create --name myenv --channel conda-forge pip
$ conda activate myenv
$ pip install git+https://github.com/bjlittle/geovista.git@main

pip

$ pip install git+https://github.com/bjlittle/geovista.git@main

pixi

$ pixi init myenv
$ cd myenv
$ pixi add python
$ pixi add --git https://github.com/bjlittle/geovista.git geovista --branch main --pypi

uv

$ uv pip install "git+https://github.com/bjlittle/geovista.git@main"

Developer

---

To configure a full developer environment, first clone the geovista repository:

$ git clone git@github.com:bjlittle/geovista.git

Change to the geovista root directory of the cloned repository:

$ cd geovista

Now install geovista and all its dependencies:

conda

$ conda env create --file requirements/geovista.yml
$ conda activate geovista

pip

$ pip install --editable .[all]

pixi

$ pixi shell --environment geovista

uv

$ uv pip install --editable ".[all]"

For extra credit, install our developer pre-commit git-hooks:

$ pre-commit install

Finally, you’re good to roll 🥳