以下是在 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"
}
  • 實現步驟:
    1. 將腳本儲存為可執行的文件 (例如:~/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 在本地運行模型。

重要提示:

Popular Tags