安裝

系統需求

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

Python 3.10 以上
uv

安裝 uv

macOS Linux Windows

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"

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

Homebrew MacPorts WinGet Scoop pipx Cargo

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

安裝套件

utility-viz 2.0 目前為 Beta 版

utility-viz 2.0.0b1 是預先發行版（pre-release）。在 2.0 正式版釋出之前，穩定版仍是 econ-viz 1.x。預先發行版預設會被略過，因此下列指令加上了 --pre（pip）或 --prerelease allow（uv）。從 econ-viz 升級？請見從 econ-viz 遷移。

使用 pip：

pip install --pre utility-viz

使用 uv，建立專案並將 utility-viz 加入依賴：

uv init my-diagrams
cd my-diagrams
uv add --prerelease allow utility-viz

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

uv run python main.py

選用依賴

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

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

全域安裝命令列工具

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

uv tool install --prerelease allow utility-viz

開發環境設定

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

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

uv run pytest

驗證安裝

uv run utility-viz --version
uv run utility-viz help

安裝