Installation¶

You can install VectorBT with pip, the Python package manager, or with Docker.

With pip¶

pip install -U vectorbt

To also install optional dependencies:

pip install -U "vectorbt[full]"

With Docker¶

You can pull the most recent Docker image if you have Docker installed.

docker run --rm -p 8888:8888 -v "$PWD":/home/jovyan/work polakowo/vectorbt:latest-full

This command pulls the latest polakowo/vectorbt:latest-full image from Docker Hub. It then starts a container running a Jupyter server and exposes it on host port 8888. Visiting http://127.0.0.1:8888/?token=<token> in a browser opens JupyterLab, where <token> is the secret token printed in the console.

Docker removes the container when the notebook server exits, but any files written to the working directory inside the container remain available in the working directory on the host (because the current directory is mounted into the container). See Jupyter Docker Stacks - Quick Start.

There are two types of images in polakowo/vectorbt: the vanilla version and the full version (with optional dependencies). To use the vanilla version, use polakowo/vectorbt:latest instead of polakowo/vectorbt:latest-full.

Each Docker image is based on jupyter/scipy-notebook and comes with a Jupyter environment, vectorbt, and other scientific packages installed.

docker run --rm -p 10000:8888 -v "$PWD":/home/jovyan/work polakowo/vectorbt:latest-full

With git¶

Of course, you can pull vectorbt directly from git:

git clone git@github.com:polakowo/vectorbt.git vectorbt

Install the package:

pip install -e vectorbt

Troubleshooting¶

• TA-Lib
• Jupyter Notebook and JupyterLab
• Apple M1