在開始安裝之前,我們建議使用 Anaconda 作為開發環境。
為避免環境的套件衝突,創建虛擬環境是相當重要的。因此我們建議先建立虛擬環境後,逐一安裝所需的套件。
以下我們建議兩種建立虛擬環境的方式(擇一即可)
(方法一)
# 透過Anaconda指令
# 於Anaconda Prompt
# create virtual env
$ conda create -n <env_name> python=3.10
# activate virtual env
$ conda activate <env_name>
# download packages
$ pip install zipline-tej
$ pip install notebook
$ conda install -c conda-forge nb_conda_kernels
(方法二)
# 透過Python原生指令
# 於CMD
# create virtual env
$ python -m venv venv
# activate virtual env
$ venv\Scripts\activate.bat
# download packages
$ pip install zipline-tej
$ pip install notebook
下載tquant_jupyter (Jupyter使用)
下載tquant_bash (排程使用)
$ # 於終端機透過 cd 到已下載 dockerfile的目錄之下
$ docker build -f tquant_jupyter . -t "tquant:latest"
# 於終端機輸入以下指令
$ docker pull tej87681088/tquant:latest
# 於終端機輸入以下指令
$ docker volume create data
# 於終端機輸入以下指令
(若透過方法一下載)
$ docker run -v data:/app -p 8888:8888 --name tquant tquant
(若透過方法二下載)
$ docker run -v data:/app -p 8888:8888 --name tquant tej87681088/tquant
此命令將會啟動一個container並將container內部的 8888 埠映射到本機的 8888 埠,並且將可以透過volume傳輸資料
(以筆者Windows10的電腦為例:volume的位置在 \\wsl$\docker-desktop-data\data\docker\volumes\data\_data)
(若希望不要保留container,可加入 --rm)
$ http://127.0.0.1:8888/tree?token=XXXXXXXXXXXXXXXX
# 找尋container ID
$ docker ps -a
# 啟動 指定container
$ docker start <CONTAINER_ID>
# 顯示 container 內部終端機最近印出的提示
$ docker logs --tail 3 <CONTAINER_ID>
Anaconda Prompt
一鍵安裝 zipline-tej¶首先,需要下載以下套件文件。
Windows (zipline-tej.yml)
接著,在 Anaconda 的命令提示字元中,創建一個虛擬環境並安裝相應版本的依賴套件。我們強烈推薦使用虛擬環境,以保持每個項目的獨立性。(原因說明)
Window 使用者
# 將下載好的 zipline-tej.yml檔案放在以下路徑中
$ cd <C:\Users\username\Downloads>
# 透過yml檔安裝所需套件並創建虛擬環境
$ conda env create -f zipline-tej.yml
# 開啟虛擬環境
$ conda activate zipline-tej
Mac 使用者
# 將下載好的 zipline-tej.yml檔案放在以下路徑中
$ cd <C:\Users\username\Downloads>
# 創建虛擬環境
$ conda env create -f zipline-tej_mac.yml
# 開啟虛擬環境
$ conda activate zipline-tej
若已安裝好zipline-tej,我們可透過以下指令顯示當前zipline-tej的版本。
!pip show zipline-tej
為確保當前版本為最新,可以透過以下指令以更新zipline-tej。
!pip install --upgrade zipline-tej