mirror of
https://github.com/tcsenpai/agenticSeek.git
synced 2025-06-05 02:25:27 +00:00
add simplified chinese readme
This commit is contained in:
martin legrand
parent
46c3b7c17e
commit
7f4c96371e
478
README_CHS.md
Normal file
478
README_CHS.md
Normal file
@ -0,0 +1,478 @@
|
||||
<p align="center">
|
||||
<img align="center" src="./media/whale_readme.jpg">
|
||||
<p>
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
[English](./README.md) | 中文
|
||||
|
||||
# AgenticSeek: 类似 Manus 但基于 Deepseek R1 Agents 的本地模型。
|
||||
|
||||
|
||||
**Manus AI 的本地替代品**，它是一个具有语音功能的大语言模型秘书，可以 Coding、访问你的电脑文件、浏览网页，并自动修正错误与反省，最重要的是不会向云端传送任何资料。采用 DeepSeek R1 等推理模型构建，完全在本地硬体上运行，进而保证资料的隐私。
|
||||
|
||||
[](https://fosowl.github.io/agenticSeek.html)  [](https://discord.gg/4Ub2D6Fj)
|
||||
|
||||
> 🛠️ **目前还在开发阶段** – 欢迎任何贡献者加入我们！
|
||||
|
||||
|
||||
> *Do a deep search of AI startup in Osaka and Tokyo, find at least 5, then save in the research_japan.txt file*
|
||||
|
||||
> *Can you make a tetris game in C ?*
|
||||
|
||||
> *I would like to setup a new project file index as mark2.*
|
||||
|
||||
|
||||
### AgenticSeek 可以进行任务规划！
|
||||
|
||||
|
||||
|
||||
## Features:
|
||||
|
||||
- **100% 本机运行**: 本机运行，不使用云端服务，所以资料绝不会散布出去，我的东西还是我的！不会被当作其他服务的训练资料。
|
||||
|
||||
- **文件的交互系统**: 使用 bash 去浏览本机资料和操作本机系统。
|
||||
|
||||
- **自主 Coding**: AgenticSeek 可以自己运行、Debug、编译 Python、C、Golang 和各种语言。
|
||||
|
||||
- **代理助理**: 不同的工作由不同的助理去处理问题。AgenticSeek 会自己寻找最适合的助理去做相对应的工作。
|
||||
|
||||
- **规划**: 对于复杂的任务，AgenticSeek 会交办给不同的助理进行规划和执行。
|
||||
|
||||
- **自主学习**: 自动在网路上寻找资料。
|
||||
|
||||
- **记忆功能**: 对于每次的对话进行统整、保存对话，并且在本地储存用户的使用习惯。
|
||||
|
||||
---
|
||||
|
||||
## **安装**
|
||||
|
||||
确保已安装了 Chrome driver，Docker 和 Python 3.10（或更新）。
|
||||
|
||||
有关于 Chrome driver 的问题，请参见 **Chromedriver** 部分。
|
||||
|
||||
### 1️⃣ **复制储存库与设置环境变数**
|
||||
|
||||
```sh
|
||||
git clone https://github.com/Fosowl/agenticSeek.git
|
||||
cd agenticSeek
|
||||
mv .env.example .env
|
||||
```
|
||||
|
||||
### 2️ **建立虚拟环境**
|
||||
|
||||
```sh
|
||||
python3 -m venv agentic_seek_env
|
||||
source agentic_seek_env/bin/activate
|
||||
# On Windows: agentic_seek_env\Scripts\activate
|
||||
```
|
||||
|
||||
### 3️⃣ **安装所需套件**
|
||||
|
||||
**自动安装:**
|
||||
|
||||
```sh
|
||||
./install.sh
|
||||
```
|
||||
|
||||
**手动安装:**
|
||||
|
||||
```sh
|
||||
pip3 install -r requirements.txt
|
||||
# or
|
||||
python3 setup.py install
|
||||
```
|
||||
|
||||
|
||||
## 在本地机器上运行 AgenticSeek
|
||||
|
||||
**建议至少使用 Deepseek 14B 以上参数的模型，较小的模型难以使用助理功能并且很快就会忘记上下文之间的关系。**
|
||||
|
||||
### 1️⃣ **下载模型**
|
||||
|
||||
确定已经安装 [Ollama](https://ollama.com/)。
|
||||
|
||||
请在 [DeepSeek](https://deepseek.com/models) 下载至少大于 `deepseek-r1:14b` 的模型。
|
||||
|
||||
```sh
|
||||
ollama pull deepseek-r1:14b
|
||||
```
|
||||
|
||||
### 2️ **启动框架 （ollama）**
|
||||
|
||||
启动 Ollama 服务器。
|
||||
```sh
|
||||
ollama serve
|
||||
```
|
||||
|
||||
请更改 `config.ini` 文件，将 `provider_name` 设置为 `ollama` 并且 `provider_model` 设置为你刚刚下载的模型，如 `deepseek-r1:14b`。
|
||||
|
||||
注意：`deepseek-r1:14b` 只是范例，如果你的电脑允许的话，请使用更大的模型。
|
||||
|
||||
```sh
|
||||
[MAIN]
|
||||
is_local = True
|
||||
provider_name = ollama
|
||||
provider_model = deepseek-r1:14b
|
||||
provider_server_address = 127.0.0.1:11434
|
||||
```
|
||||
|
||||
开始所有服务:
|
||||
|
||||
```sh
|
||||
sudo ./start_services.sh # MacOS
|
||||
start ./start_services.cmd # Window
|
||||
```
|
||||
|
||||
|
||||
运行 AgenticSeek:
|
||||
|
||||
```sh
|
||||
python3 main.py
|
||||
```
|
||||
|
||||
*如果你不知道如何开始，请参阅 **Usage** 部分*
|
||||
|
||||
*如果遇到问题，请先参考 **Known issues** 部分*
|
||||
|
||||
|
||||
*如果你的电脑无法在本机运行 deepseek，也许你可以试看看 API 的方式，参见 **Run with an API***
|
||||
|
||||
*有关设定档的详细解释，请参阅 **Config** 部分。*
|
||||
|
||||
---
|
||||
|
||||
## Usage （使用方法）
|
||||
|
||||
确定所有的核心档案都启用了，也就是执行过这条命令 `./start_services.sh` 然后你就可以使用 `python3 main.py` 来启动 AgenticSeek 了！
|
||||
|
||||
```sh
|
||||
sudo ./start_services.sh
|
||||
python3 main.py
|
||||
```
|
||||
|
||||
当你看到执行后显示 `>>> `
|
||||
这表示一切运作正常，AgenticSeek 正在等待你给他任何指令。
|
||||
你也可以透过设定 `config.ini` 内的 `listen = True` 来启用语音转文字。
|
||||
|
||||
要退出时，只要和他说 `goodbye` 就可以退出！
|
||||
|
||||
以下是一些用法：
|
||||
|
||||
### Coding/Bash
|
||||
|
||||
> *Help me with matrix multiplication in Golang*
|
||||
|
||||
> *Scan my network with nmap, find if any suspicious devices is connected*
|
||||
|
||||
> *Make a snake game in python*
|
||||
|
||||
### 网路搜寻
|
||||
|
||||
> *Do a web search to find cool tech startup in Japan working on cutting edge AI research*
|
||||
|
||||
> *Can you find on the internet who created agenticSeek?*
|
||||
|
||||
> *Can you find on which website I can buy a rtx 4090 for cheap*
|
||||
|
||||
### 档案浏览与搜寻
|
||||
|
||||
> *Hey can you find where is million_dollars_contract.pdf i lost it*
|
||||
|
||||
> *Show me how much space I have left on my disk*
|
||||
|
||||
> *Find and read the README.md and follow the install instruction*
|
||||
|
||||
### 日常聊天
|
||||
|
||||
> *Tell me about France*
|
||||
|
||||
> *What is the meaning of life ?*
|
||||
|
||||
> *Should I take creatine before or after workout?*
|
||||
|
||||
|
||||
当你把指令送出后，AgenticSeek 会自动调用最能提供帮助的助理，去完成你交办的工作和指令。
|
||||
|
||||
但也有可能出现怪怪的情况，或是你要找飞机机票，他跑去教你如何一步步做出一台飞机（开玩笑的，但真的可能出现），因为这是一个早期专案，我们会努力教导他、完善他的！
|
||||
|
||||
所以我们希望你在使用时，能明确地表明你希望他要怎么做，下面给你一个范例！
|
||||
|
||||
你该说：
|
||||
`Do a web search and find out which are the best country for solo-travel`
|
||||
|
||||
|
||||
而不是说：
|
||||
`Do you know some good countries for solo-travel?`
|
||||
|
||||
---
|
||||
|
||||
## **在本地执行属于你的 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
|
||||
```
|
||||
|
||||
执行 AgenticSeek：
|
||||
|
||||
```sh
|
||||
sudo ./start_services.sh
|
||||
python3 main.py
|
||||
```
|
||||
|
||||
## **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。
|
||||
|
||||
执行 AgenticSeek：
|
||||
|
||||
```sh
|
||||
sudo ./start_services.sh
|
||||
python3 main.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 语音转文字
|
||||
|
||||
预设状况下，语音转文字功能是停用的。若要启用它，请在 `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
|
||||
[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
|
||||
- 隐私模式，但需要你自己安装反爬虫扩充功能。
|
||||
|
||||
## 框架
|
||||
|
||||
下表显示了可用的框架：
|
||||
|
||||
| 框架 | 本地? | 描述|
|
||||
|-|-|-|
|
||||
| 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：我需要什么的硬体配备？**
|
||||
|
||||
7B 型号：具有 8GB VRAM 的 GPU。
|
||||
14B 型号：12GB GPU（例如 RTX 3060）。
|
||||
32B 型号：24GB+ VRAM。
|
||||
|
||||
**Q：为什么选择 Deepseek R1 而不是其他模型？**
|
||||
|
||||
就其尺寸而言，Deepseek R1 在推理和使用方面表现出色。我们认为非常适合我们的需求，其他模型也很好用，但 Deepseek 是我们最后选定的模型。
|
||||
|
||||
**Q：我在执行时 `main.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 相比起来更有趣且易使用的方案！
|
||||
|
||||
## 贡献
|
||||
|
||||
我们正在寻找开发者来改善 AgenticSeek！你可以在 Issues 查看未解决的问题或和我们讨论更酷的新功能！
|
||||
|
||||
[](https://www.star-history.com/#Fosowl/agenticSeek&Date)
|
||||
|
||||
## 作者:
|
||||
> [Fosowl](https://github.com/Fosowl)
|
||||
> [steveh8758](https://github.com/steveh8758)
|
||||
Loading…
x
Reference in New Issue
Block a user