diff --git a/README.md b/README.md index d169a6e..496a5f1 100644 --- a/README.md +++ b/README.md @@ -58,6 +58,10 @@ source agentic_seek_env/bin/activate ### 3️⃣ **Install package** +Ensure Python, Docker and docker compose, and Google chrome are installed. + +We recommand Python 3.10.0. + **Automatic Installation (Recommanded):** For Linux/Macos: @@ -66,41 +70,51 @@ For Linux/Macos: ``` For windows: + ```sh ./install.bat ``` **Manually:** -First, you need to install these packages: +**Note: For any OS, ensure the ChromeDriver you install matches your installed Chrome version. Run `google-chrome --version`. See known issues if you have chrome >135** - *Linux*: -Updates package list (apt-get update). +Update Package List: `sudo apt update` -Install these: -alsa-utils, portaudio19-dev, python3-pyaudio, libgtk-3-dev, libnotify-dev, libgconf-2-4, libnss3, libxss1, selenium +Install Dependencies: `sudo apt install -y alsa-utils portaudio19-dev python3-pyaudio libgtk-3-dev libnotify-dev libgconf-2-4 libnss3 libxss1` -Make sure to install docker + docker-compose if not already. +Install ChromeDriver matching your Chrome browser version: +`sudo apt install -y chromium-chromedriver` + +Install requirements: `pip3 install -r requirements.txt` - *Macos*: -Update package list. -Install chromedriver. -Install portaudio. -Install chromedriver and selenium. +Update brew : `brew update` + +Install chromedriver : `brew install --cask chromedriver` + +Install portaudio: `brew install portaudio` + +Upgrade pip : `python3 -m pip install --upgrade pip` + +Upgrade wheel : : `pip3 install --upgrade setuptools wheel` + +Install requirements: `pip3 install -r requirements.txt` - *Windows*: -Install pyreadline3, selenium portaudio, pyAudio and chromedriver +Install pyreadline3 `pip install pyreadline3` -Then install pip requirements: +Install portaudio manually (e.g., via vcpkg or prebuilt binaries) and then run: `pip install pyaudio` -```sh -pip3 install -r requirements.txt -# or -python3 setup.py install -``` +Download and install chromedriver manually from: https://sites.google.com/chromium.org/driver/getting-started + +Place chromedriver in a directory included in your PATH. + +Install requirements: `pip3 install -r requirements.txt` --- @@ -121,26 +135,38 @@ See below for a list of local supported provider. **Update the config.ini** -Change the config.ini file to set the provider_name to a supported provider and provider_model to `deepseek-r1:14b` +Change the config.ini file to set the provider_name to a supported provider and provider_model to a LLM supported by your provider. We recommand reasoning model such as *Qwen* or *Deepseek*. -NOTE: `deepseek-r1:14b`is an example, use a bigger model if your hardware allow it. +See the **FAQ** at the end of the README for required hardware. ```sh [MAIN] -is_local = True +is_local = True # Whenever you are running locally or with remote provider. provider_name = ollama # or lm-studio, openai, etc.. -provider_model = deepseek-r1:14b +provider_model = deepseek-r1:14b # choose a model that fit your hardware provider_server_address = 127.0.0.1:11434 +agent_name = Jarvis # name of your AI +recover_last_session = True # whenever to recover the previous session +save_session = True # whenever to remember the current session +speak = True # text to speech +listen = False # Speech to text, only for CLI +work_dir = /Users/mlg/Documents/workspace # The workspace for AgenticSeek. +jarvis_personality = False # Whenever to use a more "Jarvis" like personality, not recommanded with small model +languages = en zh # The list of languages, Text to speech will default to the first language on the list +[BROWSER] +headless_browser = True # Whenever to use headless browser, recommanded only if you use web interface. +stealth_mode = True # Use undetected selenium to reduce browser detection ``` +Note: Some provider (eg: lm-studio) require you to have `http://` in front of the IP. For example `http://127.0.0.1:1234` + **List of local providers** | Provider | Local? | Description | |-----------|--------|-----------------------------------------------------------| | ollama | Yes | Run LLMs locally with ease using ollama as a LLM provider | | lm-studio | Yes | Run LLM locally with LM studio (set `provider_name` to `lm-studio`)| -| openai | Yes | Use openai compatible API | - +| openai | Yes | Use openai compatible API (eg: llama.cpp server) | Next step: [Start services and run AgenticSeek](#Start-services-and-Run) @@ -476,6 +502,27 @@ And download the chromedriver version matching your OS. If this section is incomplete please raise an issue. +## connection adapters Issues + +``` +Exception: Provider lm-studio failed: HTTP request failed: No connection adapters were found for '127.0.0.1:11434/v1/chat/completions' +``` + +Make sure you have `http://` in front of the provider IP address : + +`provider_server_address = http://127.0.0.1:11434` + +## SearxNG base URL must be provided + +``` +raise ValueError("SearxNG base URL must be provided either as an argument or via the SEARXNG_BASE_URL environment variable.") +ValueError: SearxNG base URL must be provided either as an argument or via the SEARXNG_BASE_URL environment variable. +``` + +Maybe you didn't move `.env.example` as `.env` ? You can also export SEARXNG_BASE_URL: + +`export SEARXNG_BASE_URL="http://127.0.0.1:8080"` + ## FAQ **Q: What hardware do I need?** @@ -517,6 +564,6 @@ We’re looking for developers to improve AgenticSeek! Check out open issues or > [Fosowl](https://github.com/Fosowl) | Paris Time | (Sometime busy) - > [https://github.com/antoineVIVIES](https://github.com/antoineVIVIES) | Taipei Time | (Often busy) + > [https://github.com/antoineVIVIES](antoineVIVIES) | Taipei Time | (Often busy) > [steveh8758](https://github.com/steveh8758) | Taipei Time | (Always busy) \ No newline at end of file diff --git a/README_CHS.md b/README_CHS.md index 7fb71b4..403e6fa 100644 --- a/README_CHS.md +++ b/README_CHS.md @@ -1,43 +1,32 @@ +# AgenticSeek: Private, Local Manus Alternative. +

- [English](./README.md) | 中文 | [日本語](./README_JP.md) -# AgenticSeek: 類似 Manus 但基於 Deepseek R1 Agents 的本地模型。 - -**Manus AI 的本地替代品**，它是一个具有语音功能的大语言模型秘书，可以 Coding、访问你的电脑文件、浏览网页，并自动修正错误与反省，最重要的是不会向云端传送任何资料。采用 DeepSeek R1 等推理模型构建，完全在本地硬体上运行，进而保证资料的隐私。 +*一个 **100% 本地替代 Manus AI** 的方案，这款支持语音的 AI 助理能够自主浏览网页、编写代码和规划任务，同时将所有数据保留在您的设备上。专为本地推理模型量身打造，完全在您自己的硬件上运行，确保完全的隐私保护和零云端依赖。* [![Visit AgenticSeek](https://img.shields.io/static/v1?label=Website&message=AgenticSeek&color=blue&style=flat-square)](https://fosowl.github.io/agenticSeek.html) ![License](https://img.shields.io/badge/license-GPL--3.0-green) [![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white)](https://discord.gg/8hGDaME3TC) [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/fosowl.svg?style=social&label=Update%20%40Fosowl)](https://x.com/Martin993886460) -> 🛠️ **目前还在开发阶段** – 欢迎任何贡献者加入我们！ +### 为什么选择 AgenticSeek？ + +* 🔒 完全本地化与隐私保护 - 所有功能都在您的设备上运行 — 无云端服务，无数据共享。您的文件、对话和搜索始终保持私密。 + +* 🌐 智能网页浏览 - AgenticSeek 能够自主浏览互联网 — 搜索、阅读、提取信息、填写网页表单 — 全程无需人工操作。 + +* 💻 自主编码助手 - 需要代码？它可以编写、调试并运行 Python、C、Go、Java 等多种语言的程序 — 全程无需监督。 + +* 🧠 智能代理选择 - 您提问，它会自动选择最适合该任务的代理。就像拥有一个随时待命的专家团队。 + +* 📋 规划与执行复杂任务 - 从旅行规划到复杂项目 — 它能将大型任务分解为步骤，并利用多个 AI 代理完成工作。 + +* 🎙️ 语音功能 - 清晰、快速、未来感十足的语音与语音转文本功能，让您能像科幻电影中一样与您的个人 AI 助手对话。 https://github.com/user-attachments/assets/4bd5faf6-459f-4f94-bd1d-238c4b331469 -> *在大阪和东京深入搜寻人工智慧新创公司，至少找到 5 家，然后储存在 research_japan.txt 档案中* - -> *你可以用 C 语言制作俄罗斯方块游戏吗？* - -> *我想设定一个新的专案档案索引，命名为 mark2。* - - - -## Features: - -- **100% 本机运行**: 本机运行，不使用云端服务，所以资料绝不会散布出去，我的东西还是我的！不会被当作其他服务的训练资料。 - -- **文件的交互系统**: 使用 bash 去浏览本机资料和操作本机系统。 - -- **自主 Coding**: AgenticSeek 可以自己运行、Debug、编译 Python、C、Golang 和各种语言。 - -- **代理助理**: 不同的工作由不同的助理去处理问题。AgenticSeek 会自己寻找最适合的助理去做相对应的工作。 - -- **规划**: 对于复杂的任务，AgenticSeek 会交办给不同的助理进行规划和执行。 - -- **自主学习**: 自动在网路上寻找资料。 - -- **记忆功能**: 对于每次的对话进行统整、保存对话，并且在本地储存用户的使用习惯。 +> 🛠️ **目前还在开发阶段** – 欢迎任何贡献者加入我们！ --- @@ -79,11 +68,47 @@ pip3 install jieba cn2an **手动安装:** -```sh -pip3 install -r requirements.txt -# or -python3 setup.py install -``` + +**注意：对于任何操作系统，请确保您安装的 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 @@ -99,18 +124,35 @@ ollama serve 请参阅下方支持的本地提供者列表。 -修改 `config.ini` 文件，将 `provider_name` 设置为支持的提供者，并将 `provider_model` 设置为 `deepseek-r1:14b`。 +**更新 config.ini** -注意：`deepseek-r1:14b` 只是一个示例，如果你的硬件允许，可以使用更大的模型。 +修改 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 +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）需要在 IP 前面加上 `http://`。例如 `http://127.0.0.1:1234` + + + **本地提供者列表** | 提供者 | 本地? | 描述 | diff --git a/README_CHT.md b/README_CHT.md index a12df6f..19bde7b 100644 --- a/README_CHT.md +++ b/README_CHT.md @@ -1,3 +1,5 @@ +# AgenticSeek: 類似 Manus 但基於 Deepseek R1 Agents 的本地模型。 +

@@ -5,40 +7,28 @@ -------------------------------------------------------------------------------- [English](./README.md) | 繁體中文 | [日本語](./README_JP.md) -# AgenticSeek: 類似 Manus 但基於 Deepseek R1 Agents 的本地模型。 - -**Manus AI 的本地替代品**，它是一個具有語音功能的大語言模型秘書，可以 Coding、訪問你的電腦文件、瀏覽網頁，並自動修正錯誤與反省，最重要的是不會向雲端傳送任何資料。採用 DeepSeek R1 等推理模型構建，完全在本地硬體上運行，進而保證資料的隱私。 +*一个 **100% 本地替代 Manus AI** 的方案，这款支持语音的 AI 助理能够自主浏览网页、编写代码和规划任务，同时将所有数据保留在您的设备上。专为本地推理模型量身打造，完全在您自己的硬件上运行，确保完全的隐私保护和零云端依赖。* [![Visit AgenticSeek](https://img.shields.io/static/v1?label=Website&message=AgenticSeek&color=blue&style=flat-square)](https://fosowl.github.io/agenticSeek.html) ![License](https://img.shields.io/badge/license-GPL--3.0-green) [![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white)](https://discord.gg/8hGDaME3TC) [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/fosowl.svg?style=social&label=Update%20%40Fosowl)](https://x.com/Martin993886460) -> 🛠️ **目前還在開發階段** – 歡迎任何貢獻者加入我們！ +### 为什么选择 AgenticSeek？ + +* 🔒 完全本地化与隐私保护 - 所有功能都在您的设备上运行 — 无云端服务，无数据共享。您的文件、对话和搜索始终保持私密。 + +* 🌐 智能网页浏览 - AgenticSeek 能够自主浏览互联网 — 搜索、阅读、提取信息、填写网页表单 — 全程无需人工操作。 + +* 💻 自主编码助手 - 需要代码？它可以编写、调试并运行 Python、C、Go、Java 等多种语言的程序 — 全程无需监督。 + +* 🧠 智能代理选择 - 您提问，它会自动选择最适合该任务的代理。就像拥有一个随时待命的专家团队。 + +* 📋 规划与执行复杂任务 - 从旅行规划到复杂项目 — 它能将大型任务分解为步骤，并利用多个 AI 代理完成工作。 + +* 🎙️ 语音功能 - 清晰、快速、未来感十足的语音与语音转文本功能，让您能像科幻电影中一样与您的个人 AI 助手对话。 https://github.com/user-attachments/assets/4bd5faf6-459f-4f94-bd1d-238c4b331469 -> *在大阪和東京深入搜尋人工智慧新創公司，至少找到 5 家，然後儲存在 research_japan.txt 檔案中* - -> *你可以用 C 語言製作俄羅斯方塊遊戲嗎？* - -> *我想設定一個新的專案檔案索引，命名為 mark2。* - - - -## Features: - -- **100% 本機運行**: 本機運行，不使用雲端服務，所以資料絕不會散布出去，我的東西還是我的！不會被當作其他服務的訓練資料。 - -- **文件的交互系統**: 使用 bash 去瀏覽本機資料和操作本機系統。 - -- **自主 Coding**: AgenticSeek 可以自己運行、Debug、編譯 Python、C、Golang 和各種語言。 - -- **代理助理**: 不同的工作由不同的助理去處理問題。AgenticSeek 會自己尋找最適合的助理去做相對應的工作。 - -- **規劃**: 對於複雜的任務，AgenticSeek 會交辦給不同的助理進行規劃和執行。 - -- **自主學習**: 自動在網路上尋找資料。 - -- **記憶功能**: 對於每次的對話進行統整、保存對話，並且在本地儲存用戶的使用習慣。 +> 🛠️ **目前還在開發階段** – 歡迎任何貢獻者加入我們！ --- @@ -80,11 +70,45 @@ pip3 install jieba cn2an **手動安裝:** -```sh -pip3 install -r requirements.txt -# or -python3 setup.py install -``` + +**注意：对于任何操作系统，请确保您安装的 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 diff --git a/README_FR.md b/README_FR.md index 1cdd791..e11b28a 100644 --- a/README_FR.md +++ b/README_FR.md @@ -74,9 +74,44 @@ source agentic_seek_env/bin/activate **Manuel:** -```sh -pip3 install -r requirements.txt -``` +**Note : Pour tous les systèmes d'exploitation, assurez-vous que le ChromeDriver que vous installez correspond à la version de Chrome installée. Exécutez `google-chrome --version`. Consultez les problèmes connus si vous avez Chrome >135** + +- *Linux*: + +Mettre à jour la liste des paquets : `sudo apt update` + +Installer les dépendances : `sudo apt install -y alsa-utils portaudio19-dev python3-pyaudio libgtk-3-dev libnotify-dev libgconf-2-4 libnss3 libxss1` + +Installer ChromeDriver correspondant à la version de votre navigateur Chrome : +`sudo apt install -y chromium-chromedriver` + +Installer les prérequis : `pip3 install -r requirements.txt` + +- *macOS*: + +Mettre à jour brew : `brew update` + +Installer chromedriver : `brew install --cask chromedriver` + +Installer portaudio : `brew install portaudio` + +Mettre à jour pip : `python3 -m pip install --upgrade pip` + +Mettre à jour wheel : `pip3 install --upgrade setuptools wheel` + +Installer les prérequis : `pip3 install -r requirements.txt` + +- *Windows*: + +Installer pyreadline3 : `pip install pyreadline3` + +Installer portaudio manuellement (par exemple, via vcpkg ou des binaires précompilés) puis exécutez : `pip install pyaudio` + +Télécharger et installer chromedriver manuellement depuis : https://sites.google.com/chromium.org/driver/getting-started + +Placez chromedriver dans un répertoire inclus dans votre PATH. + +Installer les prérequis : `pip3 install -r requirements.txt` ## Faire fonctionner sur votre machine @@ -88,18 +123,35 @@ Lancer votre provider local, par exemple avec ollama: ollama serve ``` -Voyez la section **Provider** pour la liste de provideurs disponible. +**Configurer le config.ini** -Modifiez le fichier config.ini pour définir provider_name sur le nom d'un provideur et provider_model sur le LLM à utiliser. +Modifiez le fichier config.ini pour définir provider_name sur un fournisseur supporté et provider_model sur un LLM compatible avec votre fournisseur. Nous recommandons des modèles de raisonnement comme *Qwen* ou *Deepseek*. + +Consultez la section **FAQ** à la fin du README pour connaître le matériel requis. ```sh [MAIN] -is_local = True -provider_name = ollama # ou lm-studio, openai, etc... -provider_model = deepseek-r1:14b +is_local = True # Si vous exécutez localement ou avec un fournisseur distant. +provider_name = ollama # ou lm-studio, openai, etc.. +provider_model = deepseek-r1:14b # choisissez un modèle adapté à votre matériel provider_server_address = 127.0.0.1:11434 +agent_name = Jarvis # nom de votre IA +recover_last_session = True # récupérer ou non la session précédente +save_session = True # mémoriser ou non la session actuelle +speak = True # synthèse vocale +listen = False # reconnaissance vocale, uniquement pour CLI +work_dir = /Users/mlg/Documents/workspace # L'espace de travail pour AgenticSeek. +jarvis_personality = False # Utiliser une personnalité plus "Jarvis", non recommandé avec des petits modèles +languages = en fr # Liste des langages, la synthèse vocale utilisera par défaut la première langue de la liste +[BROWSER] +headless_browser = True # Utiliser ou non le navigateur sans interface graphique, recommandé uniquement avec l'interface web. +stealth_mode = True # Utiliser selenium non détectable pour réduire la détection du navigateur ``` +Remarque : Certains fournisseurs (ex : lm-studio) nécessitent `http://` devant l'adresse IP. Par exemple `http://127.0.0.1:1234` + + + **Liste des provideurs locaux** | Fournisseur | Local ? | Description |