接下來讓我們開始實際自己開發一個 RAG。

動手寫程式之前，先把環境準備好。後面每一天的內容都會建立在同一套環境上，版本一致可以省下很多「為什麼在我電腦上跑不起來」的除錯時間。今天不寫任何 RAG 程式，先安裝 uv、建立專案及虛擬環境。

為什麼選 uv？

uv 是用 Rust 寫的 Python 套件與專案管理工具，安裝套件的速度比 pip 快很多，而且把「建立虛擬環境、管理依賴、鎖定版本」整合在同一個指令裡。專案換到別台電腦時，只要一個指令就能還原一模一樣的環境。

Step 1：安裝 uv

macOS / Linux：

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

Windows（PowerShell）：

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

也可以用 pip install uv 安裝。裝完後確認版本，有顯示版本號就代表成功：

uv --version

Step 2：建立專案與虛擬環境

本系列建議使用 Python 3.10 以上，這裡以 3.12 為例：

uv init rag-tutorial --python 3.12
cd rag-tutorial
uv venv
uv init 

會建立專案資料夾與 pyproject.toml，之後安裝的套件都會記錄在這個檔案裡。uv venv 則會在專案內建立 .venv 虛擬環境。

Step 3：啟用虛擬環境（選用）

source .venv/bin/activate        # macOS / Linux
.venv\Scripts\activate           # Windows

這一步不是必要的。uv 有 uv run 指令，執行時會自動使用專案的虛擬環境，所以你也可以完全不手動啟用。

小結

今天完成了 uv 安裝、專案與虛擬環境建立。環境就緒後，明天我們從安裝需要的套件開始。