跳轉到

安裝

系統需求

建立專案前請先安裝以下工具：

安裝 uv

curl -LsSf https://astral.sh/uv/install.sh | sh

curl -LsSf https://astral.sh/uv/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

亦可透過套件管理工具安裝：

brew install uv

sudo port install uv

winget install --id=astral-sh.uv -e

scoop install main/uv

pipx install uv

cargo install --locked uv

安裝套件

建立專案並將 econ-viz 加入依賴：

uv init my-diagrams
cd my-diagrams
uv add econ-viz

透過 uv run 於專案環境中執行程式：

uv run python main.py

選用依賴

部分功能需要額外的套件，可依需求安裝對應的選用依賴：

uv add "econ-viz[animation]"    # GIF 匯出（Pillow）
uv add "econ-viz[interactive]"  # 筆記本互動元件
uv add "econ-viz[all]"          # 全部選用依賴

全域安裝命令列工具

若僅需命令列工具，可將其安裝為獨立工具，使 econ-viz 加入 PATH：

uv tool install econ-viz

開發環境設定

git clone https://github.com/EconViz/econ-viz.git
cd econ-viz
uv sync --all-extras

uv sync 預設會安裝 dev 依賴群組，--all-extras 則會一併安裝所有選用依賴。執行測試：

uv run pytest

驗證安裝

uv run econ-viz --version   # econ-viz 1.10.0
uv run econ-viz help

留言