PyZipline/docs/getting-started/installation.md

51 lines
1.5 KiB
Markdown
Raw Normal View History

# Installation
2023-12-20 14:28:15 -05:00
/// admonition | This project is in active development
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.
## 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.
On Windows:
``` prolog title="Command Prompt"
2023-12-21 14:08:09 -05:00
py -m pip install pyzipline=0.1.0
```
On macOS and Linux:
``` prolog title="Bash"
2023-12-21 14:08:09 -05:00
python3 -m pip install pyzipline=0.1.0
```
## 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 14:31:31 -05:00
``` toml title="pyproject.toml"
[tool.poetry.dependencies]
2023-12-21 14:08:09 -05:00
pyzipline = "0.1.0"
```