2023-12-20 13:36:33 -05:00
# Installation
2023-12-20 14:28:15 -05:00
/// admonition | This project is in active development
2023-12-20 13:36:33 -05:00
type: danger
There has not been an official release of PyZipline on PyPi yet, meaning these installation docs don't work.
///
2023-12-20 14:28:15 -05:00
/// admonition | Using the correct version
type: warning
attrs: {class: annotate}
**Please make sure to install the matching version of PyZipline for your Zipline version!**
2024-03-28 11:28:30 -04:00
This documentation assumes you are using Zipline `3.7.9` .
2023-12-21 14:08:09 -05:00
If you are not, please see [Versioning ](./versioning.md ) for a list of supported versions.
2023-12-20 14:28:15 -05:00
If you're on [Zipline's `trunk` version ](https://github.com/diced/zipline/tree/trunk ), use `*` to get the latest versions of PyZipline. (1)
///
1. I will not always update to `trunk` versions, I may occassionally do so, but for the most part, expect breaking changes to recieve fixes when a new Zipline version is released.
2023-12-20 13:36:33 -05:00
## pip
You can use pip to install PyZipline.
2023-12-22 15:20:24 -05:00
The command to use differs slightly depending on what operating system you use.
2023-12-20 13:36:33 -05:00
On Windows:
``` prolog title="Command Prompt"
2023-12-21 14:08:09 -05:00
py -m pip install pyzipline=0.1.0
2023-12-20 13:36:33 -05:00
```
On macOS and Linux:
``` prolog title="Bash"
2023-12-21 14:08:09 -05:00
python3 -m pip install pyzipline=0.1.0
2023-12-20 13:36:33 -05:00
```
## Poetry
2023-12-20 14:31:31 -05:00
You can also use [Poetry ](https://python-poetry.org/ ) to store your dependencies.
Use the following command to install PyZipline:
2023-12-20 14:28:15 -05:00
2023-12-20 14:31:31 -05:00
``` prolog title="Command Prompt / Shell"
2023-12-21 14:08:09 -05:00
poetry add pyzipline=0.1.0
2023-12-20 14:28:15 -05:00
```
2023-12-20 14:31:31 -05:00
Or, you can add PyZipline to your `pyproject.toml` file manually:
2023-12-20 13:36:33 -05:00
2023-12-20 14:31:31 -05:00
``` toml title="pyproject.toml"
[tool.poetry.dependencies]
2023-12-21 14:08:09 -05:00
pyzipline = "0.1.0"
2023-12-20 13:36:33 -05:00
```