OpenWebUI (無需 Docker)
以下是在 Mac M1 (8GB RAM) 以上安裝 Open WebUI 在 Mac 上的安裝與自動化教學
1. 前提條件
- 建議 Mac M1 (8GB RAM) 以上
- 安裝了 Homebrew (如果沒有,請先安裝:https://brew.sh/)
2. 安裝步驟
- 安裝
uv
: 使用 Homebrew 安裝uv
: brew install uv
- 建立環境: 建立一個專案目錄,並初始化一個 Python 虛擬環境:
mkdir openwebui && cd openwebui uv init --python=3.11 . uv venv source .venv/bin/activate
- 安裝 Open WebUI: 使用
uv
安裝 Open WebUI:
uv pip install open-webui
- 運行 Open WebUI: 啟動 Open WebUI 服務:
open-webui serve
- Open WebUI 將可訪問於:
http://0.0.0.0:8080/
3. 自動化啟動腳本
為了方便啟動 Open WebUI,可以設置自動化腳本。這個腳本會檢查 Open WebUI 是否已經在運行,並將輸出記錄到文件。
#!/bin/bash
# Function to start OpenWebUI
startwebui() {
if pgrep -f "open-webui serve" > /dev/null; then
echo "OpenWebUI is already running"
return 1
fi
(source "$HOME/openwebui/.venv/bin/activate" &&
open-webui serve > "$HOME/logs/webui.log" 2>&1 &)
echo "OpenWebUI started. Logs at ~/logs/webui.log"
}
# Function to stop OpenWebUI
stopwebui() {
pkill -f "open-webui serve"
echo "OpenWebUI stopped"
}
- 實現步驟:
- 將腳本儲存為可執行的文件 (例如:
~/scripts/webui-control.sh
):
- 將腳本儲存為可執行的文件 (例如:
chmod +x ~/scripts/webui-control.sh
- 將腳本添加到您的 shell 配置檔案 (例如
~/.zshrc
):
source ~/scripts/webui-control.sh
- 使用方法: 在終端中輸入
startwebui
即可啟動 Open WebUI,使用stopwebui
停止。
4. 模型選擇
您可以選擇使用 OpenAI API 或本地運行模型 (例如 Ollama) 與 Open WebUI 配合使用。OpenAI API Settings 可以申請 OpenAI API Key。 此外,也可以使用 Ollama 在本地運行模型。
重要提示:
- 詳細的安裝和使用說明,請參考原始網頁:https://www.jjude.com/tech-notes/run-owui-on-mac/。