Installation

Prerequisites:

• Python 3.10 or higher

with pip recommended

PLUTUS is published as a python package and can be installed with pip, ideally by using a virtual environment. Open up a terminal and install PLUTUS with:

Latest1.x

pip install plutus-pairtrading

pip install plutus-pairtrading=="1.*" # (1)!

1. PLUTUS uses semantic versioning.

   This will make sure that you don't accidentally [upgrade to the next major version], which may include breaking changes that silently corrupt your site. Additionally, you can use pip freeze to create a lockfile, so builds are reproducible at all times:

   pip freeze > requirements.txt
   

   Now, the lockfile can be used for installation:

   pip install -r requirements.txt
   

This will automatically install compatible versions of all dependencies. PLUTUS always strives to support the latest versions, so there's no need to install the dependencies separately. PLUTUS dependencies are listed below:

numpy | pandas | plotly | requests | matplotlib | yfinance | arch | seaborn

---

Tip

If you don't have prior experience with Python, we recommend reading Using Python's pip to Manage Your Projects' Dependencies, which is a really good introduction on the mechanics of Python package management and helps you troubleshoot if you run into errors.

with git

PLUTUS can be directly used from GitHub by cloning the repository into a subfolder of your project root which might be useful if you want to use the very latest version:

git clone https://github.com/fox-techniques/plutus-pairtrading.git

Next, install the theme and its dependencies with:

pip install -e plutus-pairtrading

with poetry

Prerequisites:

• Poetry

Installing PLUTUS:

poetry add plutus-pairtrading

This command downloads and installs the package and its dependencies and adds the package as a dependency in your pyproject.toml.

Using the Package:

After installation, you can start using the package in your project. If you need to enter the virtual environment managed by Poetry, run:

poetry shell

Verify the Installation:

poetry show plutus-pairtrading

Updating the Package:

poetry update plutus-pairtrading

Add packages to a group:

poetry add --group notebook jupyter ipykernel

Install the dependencies from a group:

poetry install --with notebook