[English](./README.md) | [中文](./README_CHS.md) | 繁體中文 | [日本語](./README_JP.md) | [Português (Brasil)](./README_PTBR.md) *一個 **100% 本地替代 Manus AI** 的方案，這款支援語音的 AI 助理能夠自主瀏覽網頁、編寫代碼和規劃任務，同時將所有數據保留在您的裝置上。專為本地推理模型量身打造，完全在您自己的硬體上執行，確保完全的隱私保護和零雲端依賴。* [](https://fosowl.github.io/agenticSeek.html)  [](https://discord.gg/8hGDaME3TC) [](https://x.com/Martin993886460) ### 為什麼選擇 AgenticSeek？ * 🔒 完全本地化與隱私保護 - 所有功能都在您的裝置上執行 — 無雲端服務，無數據共享。您的檔案、對話和搜索始終保持私密。 * 🌐 智慧網頁瀏覽 - AgenticSeek 能夠自主瀏覽網頁 — 搜索、閱讀、提取資訊、填寫網頁表單 — 全程無需人工操作。 * 💻 自主編碼助手 - 需要程式碼？它可以編寫、除錯並執行 Python、C、Go、Java 等多種語言的程式 — 全程無需監督。 * 🧠 智慧代理選擇 - 您提問，它會自動選擇最適合該任務的代理。就像擁有一個隨時待命的專家團隊。 * 📋 規劃與執行復雜任務 - 從旅行規劃到複雜專案 — 它能將大型任務分解為步驟，並利用多個 AI 代理完成工作。 * 🎙️ 語音功能 - 清晰、快速、未來感十足的語音與語音轉文字功能，讓您能像科幻電影中一樣與您的個人 AI 助手對話。 https://github.com/user-attachments/assets/4bd5faf6-459f-4f94-bd1d-238c4b331469 > 🛠️ **目前還在開發階段** – 歡迎任何貢獻者加入我們！ --- ## **安裝** 確保已安裝了 Chrome driver，Docker 和 Python 3.10（或更新）。 我們強烈建議您使用 Python 3.10 進行設定，否則可能會發生依賴錯誤。 有關於 Chrome driver 的問題，請參見 **Chromedriver** 部分。 ### 1️⃣ **複製儲存庫與設定環境變數** ```sh git clone https://github.com/Fosowl/agenticSeek.git cd agenticSeek mv .env.example .env ``` ## 2️⃣ 安裝 UV 套件管理器 ### Linux/macOS: ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` ### Windows: ```powershell powershell -c "irm https://astral.sh/uv/install.ps1 | iex" ``` ## 3️⃣ 建立虛擬環境 ```bash uv venv ``` ### 4️⃣ **安裝所需套件** **自動安裝:** ```sh ./install.sh ``` ** 若要讓文字轉成語音（TTS）功能支援中文，你需要安裝 jieba（中文分詞庫）和 cn2an（中文數字轉換庫）：** ``` pip3 install jieba cn2an ``` **手動安裝:** **注意：對於不同的操作系統，請確保您安裝的 ChromeDriver 與您已安裝的 Chrome 版本匹配。執行 `google-chrome --version`。如果您的 Chrome 版本 > 135，請參閱已知問題** - *Linux*: 更新軟件包列表：`sudo apt update` 安裝依賴項：`sudo apt install -y alsa-utils portaudio19-dev python3-pyaudio libgtk-3-dev libnotify-dev libgconf-2-4 libnss3 libxss1` 安裝與您的 Chrome 瀏覽器版本匹配的 ChromeDriver： `sudo apt install -y chromium-chromedriver` 安裝 requirements：`pip3 install -r requirements.txt` - *Macos*: 更新 brew：`brew update` 安裝 chromedriver：`brew install --cask chromedriver` 安裝 portaudio：`brew install portaudio` 升級 pip：`python3 -m pip install --upgrade pip` 升級 wheel：`pip3 install --upgrade setuptools wheel` 安裝 requirements：`pip3 install -r requirements.txt` - *Windows*: 安裝 pyreadline3：`pip install pyreadline3` 手動安裝 portaudio（例如，通過 vcpkg 或預編譯的二進制檔案），然後執行：`pip install pyaudio` 從以下網址手動下載並安裝 chromedriver：https://sites.google.com/chromium.org/driver/getting-started 將 chromedriver 放置在包含在您的 PATH 中的目錄中。 安裝 requirements：`pip3 install -r requirements.txt` ## 在本地機器上執行 AgenticSeek **建議至少使用 Deepseek 14B 以上參數的模型，較小的模型難以使用助理功能並且很快就會忘記上下文之間的關係。** **本地執行助手** 啟動你的本地提供者，例如使用 ollama： ```sh ollama serve ``` 請參閱下方支援的本地提供者列表。 **更新 config.ini** 修改 config.ini 檔案以設定 provider_name 為支援的提供者，並將 provider_model 設定為該提供者支援的 LLM。我們推薦使用具有推理能力的模型，如 *Qwen* 或 *Deepseek*。 請參見 README 末尾的 **FAQ** 部分了解所需硬體。 ```sh [MAIN] is_local = True # 無論是在本地執行還是使用遠端提供者。 provider_name = ollama # 或 lm-studio, openai 等.. provider_model = deepseek-r1:14b # 選擇適合您硬體的模型 provider_server_address = 127.0.0.1:11434 agent_name = Jarvis # 您的 AI 助手的名稱 recover_last_session = True # 是否恢復之前的會話 save_session = True # 是否記住目前會話 speak = True # 文字轉語音 listen = False # 語音轉文字，僅適用於命令列界面 work_dir = /Users/mlg/Documents/workspace # AgenticSeek 的工作空間。 jarvis_personality = False # 是否使用更"賈維斯"風格的性格，不推薦在小型模型上使用 languages = en zh # 語言列表，文字轉語音將預設使用列表中的第一種語言 [BROWSER] headless_browser = True # 是否使用無頭瀏覽器，只有在使用網頁界面時才推薦使用。 stealth_mode = True # 使用無法檢測的 selenium 來減少瀏覽器檢測 ``` 警告：使用 LM-studio 執行 LLM 時，請*不要*將 provider_name 設定為 `openai`。請將其設定為 `lm-studio`。 注意：某些提供者（如 lm-studio）需要在 IP 前面加上 `http://`。例如 `http://127.0.0.1:1234` **本地提供者列表** | 提供者 | 本地? | 描述 | | --------- | ----- | ------------------------------------------------------------------- | | ollama | 是 | 使用 ollama 作為 LLM 提供者，輕鬆本地執行 LLM | | lm-studio | 是 | 使用 LM Studio 本地執行 LLM（將`provider_name` 設定為 `lm-studio`） | | openai | 否 | 使用相容的 API | 下一步： [Start services and run AgenticSeek](#Start-services-and-Run) --- ## **Run with an API （透過 API 執行）** 設定 `config.ini`。 ```sh [MAIN] is_local = False provider_name = openai provider_model = gpt-4o provider_server_address = 127.0.0.1:5000 ``` 警告：確保 `config.ini` 沒有行尾空格。 如果使用基於本機的 openai-based api 則把 `is_local` 設定為 `True`。 同時更改你的 IP 為 openai-based api 的 IP。 下一步： [Start services and run AgenticSeek](#Start-services-and-Run) --- ## Start services and Run (啟動服務並執行) 如果需要，請啟用你的 Python 環境。 ```sh source .venv/bin/activate ``` 啟動所需的服務。這將啟動 `docker-compose.yml` 中的所有服務，包括： - searxng - redis（由 redis 提供支援） - 前端 ```sh sudo ./start_services.sh # MacOS start ./start_services.cmd # Windows ``` **選項 1:** 使用 CLI 界面執行。 ```sh python3 cli.py ``` **選項 2:** 使用 Web 界面執行。 注意：目前我們建議您使用 CLI 界面。Web 界面仍在積極開發中。 啟動後端服務。 ```sh python3 api.py ``` 訪問 `http://localhost:3000/`，你應該會看到 Web 界面。 請注意，目前 Web 界面不支援訊息流式傳輸。 *如果你不知道如何開始，請參閱 **Usage** 部分* --- ## Usage （使用方法） 為確保 agenticSeek 在中文環境下正常工作，請確保在 config.ini 中設定語言選項。 languages = en zh 更多資訊請參閱 Config 部分 確定所有的核心檔案都啟用了，也就是執行過這條命令 `./start_services.sh` 然後你就可以使用 `python3 cli.py` 來啟動 AgenticSeek 了！ ```sh sudo ./start_services.sh python3 cli.py ``` 當你看到執行後顯示 `>>> ` 這表示一切運作正常，AgenticSeek 正在等待你給他任何指令。 你也可以透過設定 `config.ini` 內的 `listen = True` 來啟用語音轉文字。 要退出時，只要和他說 `goodbye` 就可以退出！ 以下是一些用法： ### Coding/Bash > *在 Golang 中幫助我進行矩陣乘法* > *使用 nmap 掃瞄我的網路，找出是否有任何可疑裝置連線* > *用 Python 製作一個貪食蛇遊戲* ### 網路搜尋 > *進行網路搜尋，找出日本從事尖端人工智慧研究的酷炫科技新創公司* > *你能在網路上找到誰創造了 AgenticSeek 嗎？* > *你能在哪個網站上找到便宜的 RTX 4090 嗎？* ### 檔案瀏覽與搜尋 > *嘿，你能找到我遺失的 million_dollars_contract.pdf 在哪裡嗎？* > *告訴我我的磁碟還剩下多少空間* > *尋找並閱讀 README.md，並按照安裝說明進行操作* ### 日常聊天 > *告訴我關於法國的事* > *人生的意義是什麼？* > *我應該在鍛鍊前還是鍛鍊後服用肌酸？* 當你把指令送出後，AgenticSeek 會自動呼叫最能提供幫助的助理，去完成你交辦的工作和指令。 但也有可能出現怪怪的情況，或是你要找飛機機票，他跑去教你如何一步步做出一臺飛機（開玩笑的，但真的可能出現），因為這是一個早期專案，我們會努力教導他、完善他的！ 所以我們希望你在使用時，能明確地表明你希望他要怎麼做，下面給你一個範例！ 你該說： - 進行網路搜索，找出哪些國家最適合獨自旅行 而不是說： - 你知道哪些國家適合獨自旅行？ --- ## **在本地執行屬於你的 LLM 伺服器** 如果你有一臺功能強大的電腦或伺服器，但你想透過筆記型電腦使用它，那麼你可以選擇在遠端伺服器上執行 LLM。 ### 1️⃣ **設定並啟動伺服器程式** 在執行 AI 模型的「伺服器」上，取得 IP 位址 ```sh ip a | grep "inet " | grep -v 127.0.0.1 | awk '{print $2}' | cut -d/ -f1 ``` 注意：請在 Windows 或 MacOS，分別使用 `ipconfig` 與 `ifconfig` 來尋找 IP 位址。 **如果你希望使用基於 Openai 的服務，請按照 *透過 API 執行* 部分進行。** 複製儲存庫並且進入 `server/` 資料夾。 ```sh git clone --depth 1 https://github.com/Fosowl/agenticSeek.git cd agenticSeek/server/ ``` 安裝伺服器所需的套件： ```sh pip3 install -r requirements.txt ``` 執行伺服器程式。 ```sh python3 app.py --provider ollama --port 3333 ``` 您可以選擇使用 `ollama` 或 `llamacpp` 作為 LLM 的服務框架。 ### 2️⃣ **執行** 在你的電腦上： - 更改 `config.ini` - `provider_name = server` - `provider_model = deepseek-r1:14b` - `provider_server_address = {你執行模型的電腦的 IP 位址}` ```sh [MAIN] is_local = False provider_name = server provider_model = deepseek-r1:14b provider_server_address = x.x.x.x:3333 ``` --- ## 語音轉文字 請注意，目前語音轉文字功能僅支援英語。 預設狀況下，語音轉文字功能是停用的。若要啟用它，請在 `config.ini` 檔案中，將 `listen` 選項設為 `True`： ``` listen = True ``` 啟用後 AgenticSeek 會聆聽你是否呼喚它，它才會開始聽你說的話，你可以在 *config.ini* 內去設定，要怎麼叫他。 ``` agent_name = Friday ``` 爲了獲得比較好的結果，我們建議使用常見的英文名稱（如 「John」 或 「Emma」）作為他的名字。 當你看到程式開始執行時，請大聲說出他的名字，就可以喚醒 AgenticSeek 去聆聽！（如：Friday） 清楚說出你的需求。 用確認短句結束你說的話，以通知 AgenticSeek 繼續。確認短句的範例包括： ``` "do it", "go ahead", "execute", "run", "start", "thanks", "would ya", "please", "okay?", "proceed", "continue", "go on", "do that", "go it", "do you understand?" ``` ## Config Config 範例： ``` [MAIN] is_local = True provider_name = ollama provider_model = deepseek-r1:1.5b provider_server_address = 127.0.0.1:11434 agent_name = Friday recover_last_session = False save_session = False speak = False listen = False work_dir = /Users/mlg/Documents/ai_folder jarvis_personality = False languages = en zh [BROWSER] headless_browser = False stealth_mode = False ``` **說明**: - is_local - True：在本地執行。 - False：在遠端伺服器執行。 - provider_name - 框架型別 - `ollama`, `server`, `lm-studio`, `deepseek-api` - provider_model - 執行的模型 - `deepseek-r1:1.5b`, `deepseek-r1:14b` - provider_server_address - 伺服器 IP - `127.0.0.1:11434` - agent_name - AgenticSeek 的名字，用作TTS的觸發單詞。 - `Friday` - recover_last_session - True：從上個對話繼續。 - False：重啟對話。 - save_session - True：儲存對話紀錄。 - False：不儲存。 - speak - True：啟用語音輸出。 - False：關閉語音輸出。 - listen - True：啟用語音輸入。 - False：關閉語音輸入。 - work_dir - AgenticSeek 擁有能存取與互動的工作目錄。 - jarvis_personality > 就是那個鋼鐵人的 JARVIS - True：啟用 JARVIS 個性。 - False：關閉 JARVIS 個性。 - headless_browser - True：前景瀏覽器。（很酷，推薦使用他 XD） - False：背景執行瀏覽器。 - stealth_mode - 隱私模式，但需要你自己安裝反爬蟲擴充功能。 - languages - 支援的語言列表。用於代理路由系統。語言列表越長，下載的模型越多。 ## 框架 下表顯示了可用的框架： | 框架 | 本地? | 描述 | | ------------ | ----- | ------------------------------------------------------------- | | ollama | 可 | 使用 ollama 框架去執行本地模型 | | server | 可 | 本地伺服器執行模型遠端呼叫 | | lm-studio | 可 | 使用 LM Studio 在本地執行 LLM（設定provider_name為lm-studio） | | openai | 不可 | 使用 ChatGPT API（無法保證隱私） | | deepseek-api | 不可 | 使用 Deepseek API (無法保證隱私) | | huggingface | 不可 | 使用 Hugging-Face API (無法保證隱私) | 若要選擇框架，請變更 `config.ini` 檔案： ``` is_local = False provider_name = openai provider_model = gpt-4o provider_server_address = 127.0.0.1:5000 ``` `is_local`: 對於任何本地執行的 LLM 都應該為 True，否則為 False。 `provider_name`: 透過名稱選擇要使用的框架，請參閱上面的框架清單。 `provider_model`: 設定 AgenticSeek 使用的模型。 `provider_server_address`: 如果不使用雲端 API，則可以將其設定為任何內容。 # Known issues （已知問題） ## Chromedriver Issues **已知問題 #1:** *chromedriver mismatch* `Exception: Failed to initialize browser: Message: session not created: This version of ChromeDriver only supports Chrome version 113 Current browser version is 134.0.6998.89 with binary path` 如果你的瀏覽器和 chromedriver 版本不一樣，就會發生這種情況。 你可以透過以下連結下載最新版本： https://developer.chrome.com/docs/chromedriver/downloads 如果您使用的是 Chrome 版本 115 或更新版本，請前往： https://googlechromelabs.github.io/chrome-for-testing/ 下載與你的作業系統相符的 chromedriver 版本。  如果有其他問題，請提供儘量詳細的敘述到 Issues 上，儘可能包含目前環境和問題是怎麼發生的。 ## FAQ **Q: 我需要什麼硬體？** | 模型大小 | GPU | 備註 | | -------- | ----------------------------- | --------------------------------------------------------- | | 7B | 8GB Vram | ⚠️ 不推薦。效能較差，經常出現幻覺，規劃代理可能會失敗。 | | 14B | 12 GB VRAM (例如 RTX 3060) | ✅ 適用於簡單任務。可能在網頁瀏覽和規劃任務上表現不佳。 | | 32B | 24+ GB VRAM (例如 RTX 4090) | 🚀 大多數任務成功，但可能仍在任務規劃上有困難。 | | 70B+ | 48+ GB Vram (例如 mac studio) | 💪 表現優異。建議用於高級使用情境。 | **Q：為什麼選擇 Deepseek R1 而不是其他模型？** 就其尺寸而言，Deepseek R1 在推理和使用方面表現出色。我們認為非常適合我們的需求，其他模型也很好用，但 Deepseek 是我們最後選定的模型。 **Q：我在執行時 `cli.py` 時出現錯誤。我該怎麼辦？** 1. 確保 Ollama 正在執行（ollama serve） 2. 你 `config.ini` 內 `provider_name` 的框架選擇正確。 3. 依賴套件已安裝 4. 如果均無效，請隨時提出 Issues，同樣儘可能包含目前環境和問題是怎麼發生的。 **Q：它真的是 100% 本地執行嗎？** 是的，透過 Ollama 或其他框架，所有語音轉文字、LLM 和文字轉語音模型都在本地執行。 *但你能選擇非本地執行（OpenAI 或其他 API），同樣也是可以的* **Q：我有 Manus 為甚麼還要用 AgenticSeek？** 這是我們因為興趣做的一個小 Side-Project，他特別的點在於是一個全部本地化的模型，而且可以像鋼鐵人裡面一樣與 `Jarvis` 對話，聽起來就超級酷的吧！隨著 Manus 的進化，我們也相應的加入更多功能！ **Q：它比 Manus 好在哪裡？** 不不不，AgenticSeek 和 Manus 是不同取向的東西，我們優先考慮的是本地執行和隱私，而不是基於雲端。這是一個與 Manus 相比起來更有趣且易使用的方案！ **Q: 是否支援中文以外的語言？** DeepSeek R1 天生會說中文 但注意：代理路由系統只懂英文，所以必須通過 config.ini 的 languages 參數（如 languages = en zh）告訴系統： 如果不設定中文？後果可能是：你讓它寫程式碼，結果跳出來個"醫生代理"（雖然我們根本沒有這個代理... 但系統會一臉懵圈！） 實際上會下載一個小型翻譯模型來協助任務分配 ## 貢獻 我們正在尋找開發者來改善 AgenticSeek！你可以在 Issues 查看未解決的問題或和我們討論更酷的新功能！ [](https://www.star-history.com/#Fosowl/agenticSeek&Date) [Contribution guide](./docs/CONTRIBUTING.md) ## 維護者: > [Fosowl](https://github.com/Fosowl) | 巴黎時間 | （有時很忙） > [antoineVIVIES](https://github.com/antoineVIVIES) | 臺北時間 | （經常很忙） > [steveh8758](https://github.com/steveh8758) | 臺北時間 | （總是很忙）