wehub-resource-sync
139 lines
6.2 KiB
Markdown
139 lines
6.2 KiB
Markdown
# QuantConnect Python Algorithm Project
|
|
|
|
This document contains information regarding how to use Python with the Lean engine, this includes how to use Python Autocomplete, setting up Lean for Python algorithms, PythonNet compilation for devs, and what imports to use to replicate the web IDE experience in your local development.
|
|
|
|
<br />
|
|
|
|
|
|
------
|
|
# Local Python Autocomplete
|
|
To enable autocomplete for your local Python IDE, install the `quantconnect-stubs` package from PyPI using the following command:
|
|
```
|
|
pip install quantconnect-stubs
|
|
```
|
|
|
|
To update your autocomplete to the latest version, you can run the following command:
|
|
```
|
|
pip install --upgrade quantconnect-stubs
|
|
```
|
|
|
|
Copy and paste the imports found [here](#python-autocomplete-imports) to the top of your project file to enable autocomplete.
|
|
|
|
In addition, you can use [Skylight](https://www.quantconnect.com/skylight) to automatically sync local changes to the cloud.
|
|
|
|
<br />
|
|
|
|
------
|
|
|
|
# Setup Lean Locally with Python
|
|
Before setting up python support, follow the [installation instructions](https://github.com/QuantConnect/Lean#installation-instructions) to get LEAN running C# algorithms on your machine.
|
|
|
|
|
|
## Installing Python 3.11:
|
|
|
|
Next we must prepare a Python installation for Lean to use. Follow the instructions for your OS.
|
|
|
|
<br />
|
|
|
|
### [Windows](https://github.com/QuantConnect/Lean#windows)
|
|
|
|
1. Use the Windows x86-64 MSI **Python 3.11.11** installer from [python.org](https://www.python.org/downloads/release/python-31111/) or [Anaconda](https://repo.anaconda.com/archive/Anaconda3-2024.02-1-Windows-x86_64.exe) for Windows installer.
|
|
2. When asked to select the features to be installed, make sure you select "Add python.exe to Path"
|
|
3. Create `PYTHONNET_PYDLL` environment variable to the location of your python dll in your installation (e.g. `C:\Dev\Python311\python311.dll` or `C:\Anaconda3\python311.dll`):
|
|
- Right mouse button on My Computer. Click Properties.
|
|
- Click Advanced System Settings -> Environment Variables -> System Variables
|
|
- Click **New**.
|
|
- Name: `PYTHONNET_PYDLL`
|
|
- Value: `{python dll location}`
|
|
4. Install [pandas=2.2.3](https://pandas.pydata.org/) and its [dependencies](https://pandas.pydata.org/pandas-docs/stable/install.html#dependencies).
|
|
5. Install [wrapt=1.16.0](https://pypi.org/project/wrapt/) module.
|
|
6. Reboot computer to ensure changes are propagated.
|
|
|
|
<br />
|
|
|
|
### [macOS](https://github.com/QuantConnect/Lean#macos)
|
|
|
|
1. Use the macOS x86-64 package installer from [Anaconda](https://repo.anaconda.com/archive/Anaconda3-2024.02-1-MacOSX-x86_64.pkg) and follow "[Installing on macOS](https://docs.anaconda.com/anaconda/install/mac-os)" instructions from Anaconda documentation page.
|
|
2. Set `PYTHONNET_PYDLL` environment variable to the location of your python dll in your installation directory (e.g. `/Users/{your_user_name}/anaconda3/lib/libpython3.11.dylib`):
|
|
- Open `~/.bash-profile` with a text editor of your choice.
|
|
- Add a new line to the file containing
|
|
```
|
|
export PYTHONNET_PYDLL="/{your}/{path}/{here}/libpython3.11.dylib"
|
|
```
|
|
- Save your changes, and either restart your terminal *or* execute
|
|
```
|
|
source ~/.bash-profile
|
|
```
|
|
2. Install [pandas=2.2.3](https://pandas.pydata.org/) and its [dependencies](https://pandas.pydata.org/pandas-docs/stable/install.html#dependencies).
|
|
3. Install [wrapt=1.16.0](https://pypi.org/project/wrapt/) module.
|
|
|
|
<br />
|
|
|
|
### [Linux](https://github.com/QuantConnect/Lean#linux-debian-ubuntu)
|
|
|
|
1. Install Python using miniconda by following these commands; by default, **miniconda** is installed in the users home directory (`$HOME`):
|
|
```
|
|
export PATH="$HOME/miniconda3/bin:$PATH"
|
|
wget https://cdn.quantconnect.com/miniconda/Miniconda3-py311_24.9.2-0-Linux-x86_64.sh
|
|
bash Miniconda3-py311_24.9.2-0-Linux-x86_64.sh -b -p /opt/miniconda3
|
|
rm -rf Miniconda3-py311_24.9.2-0-Linux-x86_64.sh
|
|
```
|
|
2. Create a new Python environment with the needed dependencies
|
|
```
|
|
conda create -n qc_lean python=3.11.11 pandas=2.2.3 wrapt=1.16.0
|
|
```
|
|
3. Set `PYTHONNET_PYDLL` environment variable to location of your python dll in your installation directory (e.g. `/home/{your_user_name}/miniconda3/envs/qc_lean/lib/libpython3.11.so`):
|
|
- Open `/etc/environment` with a text editor of your choice.
|
|
- Add a new line to the file containing
|
|
```
|
|
PYTHONNET_PYDLL="/home/{your_user_name}/miniconda3/envs/qc_lean/lib/libpython3.11.so"
|
|
```
|
|
- Save your changes, and logout or reboot to reflect these changes
|
|
|
|
|
|
|
|
<br />
|
|
|
|
|
|
## Run Python Algorithms
|
|
|
|
1. Update the [config](https://github.com/QuantConnect/Lean/blob/master/Launcher/config.json) to run a python algorithm:
|
|
```json
|
|
"algorithm-type-name": "BasicTemplateAlgorithm",
|
|
"algorithm-language": "Python",
|
|
"algorithm-location": "../../../Algorithm.Python/BasicTemplateAlgorithm.py",
|
|
```
|
|
2. Build LEAN.
|
|
3. Run LEAN. You should see the same result of the C# algorithm you tested earlier.
|
|
|
|
------
|
|
|
|
# Python.NET development - Python.Runtime.dll compilation
|
|
|
|
LEAN users do **not** need to compile `Python.Runtime.dll`. The information below is targeted to developers who wish to improve it. Download [QuantConnect/pythonnet](https://github.com/QuantConnect/pythonnet/) github clone or downloading the zip. If downloading the zip - unzip to a local pathway.
|
|
|
|
**Note:** QuantConnect's version of pythonnet is an enhanced version of [pythonnet](https://github.com/pythonnet/pythonnet) with added support for `System.Decimal` and `System.DateTime`.
|
|
|
|
Below are some examples of build commands that create a suitable `Python.Runtime.dll`.
|
|
|
|
```
|
|
msbuild pythonnet.sln /nologo /v:quiet /t:Clean;Rebuild
|
|
```
|
|
|
|
OR
|
|
|
|
```
|
|
dotnet build pythonnet.sln
|
|
```
|
|
|
|
------
|
|
|
|
# Python Autocomplete Imports
|
|
Adding `from AlgorithmImports import *` to the top of your Python file is enough to enable autocomplete and import the required types for the algorithm at runtime.
|
|
|
|
|
|
# Known Issues
|
|
- Python can sometimes have issues when paired with our quantconnect stubs package on Windows. This issue can cause modules not to be found because `site-packages` directory is not present in the python path. If you have the required modules installed and are seeing errors about them not being found, please try the following steps:
|
|
- remove stubs -> pip uninstall quantconnect-stubs
|
|
- reinstall stubs -> pip install quantconnect-stubs
|