Doc: readme

README.md

@@ -4,7 +4,8 @@
 
 **A fully local alternative to Manus AI**, a voice-enabled AI assistant that codes, explores your filesystem, browse the web and correct it's mistakes all without sending a byte of data to the cloud. Built with reasoning models like DeepSeek R1, this autonomous agent runs entirely on your hardware, keeping your data private.
 
-[![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)
+[![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/4Ub2D6Fj)
+
 > 🛠️ **Work in Progress** – Looking for contributors!
 
 ![alt text](./media/whale_readme.jpg)
@@ -51,7 +52,7 @@
 
 ## **Installation**
 
-Make sure you have chrome driver and docker installed.
+Make sure you have chrome driver, docker and python3.10 (or newer) installed.
 
 For issues related to chrome driver, see the **Chromedriver** section.
 
@@ -124,7 +125,7 @@ provider_server_address = 127.0.0.1:11434
 start all services :
 
 ```sh
-./start_services.sh
+sudo ./start_services.sh
 ```
 
 Run the assistant:
@@ -149,7 +150,7 @@ Warning: currently the system that choose the best AI agent routing system will
 Make sure the services are up and running with `./start_services.sh` and run the agenticSeek with `python3 main.py`
 
 ```sh
-./start_services.sh
+sudo ./start_services.sh
 python3 main.py
 ```
 
@@ -246,7 +247,7 @@ provider_server_address = x.x.x.x:5000
 Run the assistant:
 
 ```sh
-./start_services.sh
+sudo ./start_services.sh
 python3 main.py
 ```
 
@@ -267,7 +268,7 @@ provider_server_address = 127.0.0.1:5000 # can be set to anything, not used
 Run the assistant:
 
 ```sh
-./start_services.sh
+sudo ./start_services.sh
 python3 main.py
 ```
 
@@ -349,7 +350,30 @@ And download the chromedriver version matching your OS.
 
 ![alt text](./media/chromedriver_readme.png)
 
+## Docker issues
+
+**Known error #1:** *chromedriver mismatch*
+
+```
+requests.exceptions.InvalidURL: Not supported URL scheme http+docker
+Error: Failed to start containers. Check Docker logs with 'docker compose logs'.
+Possible fixes: Run with sudo or ensure port 8080 is free.
+```
+
+**Solution:**
+
+Get the PID of program using port 8080:
+
+`lsof -i :8080`
+
+If a program appear and you are not using it, kill it with:
+
+`sudo kill -9 <PID>`
+
+Run with sudo: `sudo ./start_services.sh`
+
 ## FAQ
+
 **Q: What hardware do I need?**  
 
 7B Model: GPU with 8GB VRAM.

requirements.txt

@@ -1,11 +1,11 @@
 requests==2.31.0
-openai==1.61.1
 colorama==0.4.6
 python-dotenv==1.0.0
 playsound==1.3.0
 soundfile==0.13.1
-transformers==4.48.3
+transformers==4.46.3
-torch==2.5.1
+python-dotenv==1.0.0
+torch==2.4.1
 ollama==0.4.7
 scipy==1.15.1
 kokoro==0.7.12
@@ -28,6 +28,8 @@ distro>=1.7.0,<2
 jiter>=0.4.0,<1
 sniffio
 tqdm>4
+# for api provider
+openai
 # if use chinese
 ordered_set
 pypinyin

setup.py

@@ -16,7 +16,7 @@ setup(
     include_package_data=True,
     install_requires=[
         "requests==2.31.0",
-        "openai==1.61.1",
+        "openai",
         "colorama==0.4.6",
         "python-dotenv==1.0.0",
         "playsound==1.3.0",
@@ -35,6 +35,7 @@ setup(
         "selenium==4.29.0",
         "markdownify==1.1.0",
         "text2emotion==0.0.5",
+        "python-dotenv==1.0.0",
         "langid==1.1.6",
         "httpx>=0.27,<0.29",
         "anyio>=3.5.0,<5",