From feb2e233ef835aab85fb0d8979606587cf1dcceb Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Mon, 10 Mar 2025 14:22:24 +0100
Subject: [PATCH 01/32] Update README.md

---
 README.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/README.md b/README.md
index 908b351..5879256 100644
--- a/README.md
+++ b/README.md
@@ -133,6 +133,30 @@ provider_server_address = 127.0.0.1:5000
 
 `provider_server_address`: can be set to anything if you are not using the server provider.
 
+## FAQ
+**Q: What hardware do I need?**  
+
+For Deepseek R1 7B, we recommend a  GPU with with 8GB VRAM.
+The 14B model can run on 12GB GPU like the rtx 3060.
+The 32B model needs a GPU with 24GB+ VRAM.
+
+**Q: Why Deepseek R1 over other models?**  
+
+Deepseek R1 excels at reasoning and tool use for its size. We think it’s a solid fit for our needs—other models work fine, but Deepseek is our primary pick.
+
+**Q: I get an error running `main.py`. What do I do?**  
+Ensure Ollama is running (`ollama serve`), your `config.ini` matches your provider, and dependencies are installed. If none work feel free to raise an issue.
+
+**Q: Can it really run 100% locally?**  
+Yes with Ollama or Server providers, all speech to text, LLM and text to speech model run locally. Non-local options (OpenAI, Deepseek API) are optional.
+
+**Q: How can it is older than manus ?**
+we started this a fun side project to make a fully local, Jarvis-like AI. However, with the rise of Manus and openManus, we saw the opportunity to redirected some tasks priority to make yet another alternative.
+
+**Q: How is it better than manus or openManus ?**
+
+It's not, never will be, we just offer an alternative that is more local and enjoyable to use.
+
 ## Current contributor:
 
 Fosowl 🇫🇷

From 4c1fcf3ec7913409618a08cc3b1d8a52189e31d1 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Mon, 10 Mar 2025 14:22:50 +0100
Subject: [PATCH 02/32] Update README.md

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index 5879256..f401b49 100644
--- a/README.md
+++ b/README.md
@@ -145,12 +145,15 @@ The 32B model needs a GPU with 24GB+ VRAM.
 Deepseek R1 excels at reasoning and tool use for its size. We think it’s a solid fit for our needs—other models work fine, but Deepseek is our primary pick.
 
 **Q: I get an error running `main.py`. What do I do?**  
+
 Ensure Ollama is running (`ollama serve`), your `config.ini` matches your provider, and dependencies are installed. If none work feel free to raise an issue.
 
 **Q: Can it really run 100% locally?**  
+
 Yes with Ollama or Server providers, all speech to text, LLM and text to speech model run locally. Non-local options (OpenAI, Deepseek API) are optional.
 
 **Q: How can it is older than manus ?**
+
 we started this a fun side project to make a fully local, Jarvis-like AI. However, with the rise of Manus and openManus, we saw the opportunity to redirected some tasks priority to make yet another alternative.
 
 **Q: How is it better than manus or openManus ?**

From f431b5ceec5a83d40d5687bc4dcae5682a7d4a96 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Mon, 10 Mar 2025 14:25:43 +0100
Subject: [PATCH 03/32] Update README.md

---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index f401b49..72cb840 100644
--- a/README.md
+++ b/README.md
@@ -17,10 +17,10 @@
 - **Coding abilities**: Code in Python, C, Golang, and soon more
 - **Trial-and-error**: If a command or code fails, the assistant retries to fixes it automatically, saving you time.
 - **Agent routing**: Select the best agent for the task
-- **Multi-agent (On Dev branch)**: For complex tasks, divide and conquer with multiple agents
+- **Multi-agent planning**: For complex tasks, divide and conquer with multiple agents
 - **Tools:**: All agents have their respective tools ability. Basic search, flight API, files explorer, etc...
-- **Web browsing (not implemented yet | Hight priority task)**: Browse the web autonomously to conduct task.
-- **Memory&Recovery**: Compress conversation over time to retain useful information, recover conversation session.
+- **Web browsing (Not implemented yet)**: Browse the web autonomously to conduct task.
+- **Memory**: Compress conversation over time to retain useful information, recover conversation session, remember your preferences.
 
 ---
 

From 5bf1b4f659eba023679bac3d4f5a95da405ad40f Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Mon, 10 Mar 2025 14:32:14 +0100
Subject: [PATCH 04/32] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 72cb840..4845783 100644
--- a/README.md
+++ b/README.md
@@ -152,7 +152,7 @@ Ensure Ollama is running (`ollama serve`), your `config.ini` matches your provid
 
 Yes with Ollama or Server providers, all speech to text, LLM and text to speech model run locally. Non-local options (OpenAI, Deepseek API) are optional.
 
-**Q: How can it is older than manus ?**
+**Q: How come it is older than manus ?**
 
 we started this a fun side project to make a fully local, Jarvis-like AI. However, with the rise of Manus and openManus, we saw the opportunity to redirected some tasks priority to make yet another alternative.
 

From 8a095ed60b3386757fccf73ca369be0d07e59e3b Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Mon, 10 Mar 2025 14:34:48 +0100
Subject: [PATCH 05/32] Fix : better prompt engineering

---
 prompts/planner_agent.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/prompts/planner_agent.txt b/prompts/planner_agent.txt
index 410b64f..1eac277 100644
--- a/prompts/planner_agent.txt
+++ b/prompts/planner_agent.txt
@@ -49,4 +49,4 @@ You: Sure, here is the plan:
 
 Rules:
 - Do not write code. You are a planning agent.
-- Put your plan in a json with the key "plan". Otherwise, 1000 children in africa will die.
+- Put your plan in a json with the key "plan".

From 96f4faa908e887b9e119bf4ad212f5842d137b68 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Mon, 10 Mar 2025 14:36:34 +0100
Subject: [PATCH 06/32] Update README.md

---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 4845783..7850f88 100644
--- a/README.md
+++ b/README.md
@@ -16,17 +16,17 @@
 - **Filesystem interaction**: Use bash to interact with your filesystem.
 - **Coding abilities**: Code in Python, C, Golang, and soon more
 - **Trial-and-error**: If a command or code fails, the assistant retries to fixes it automatically, saving you time.
-- **Agent routing**: Select the best agent for the task
+- **Agent routing**: Select the best agent for the task.
 - **Multi-agent planning**: For complex tasks, divide and conquer with multiple agents
 - **Tools:**: All agents have their respective tools ability. Basic search, flight API, files explorer, etc...
 - **Web browsing (Not implemented yet)**: Browse the web autonomously to conduct task.
-- **Memory**: Compress conversation over time to retain useful information, recover conversation session, remember your preferences.
+- **Memory**: Retain only useful information, recover conversation session, remember your preferences.
 
 ---
 
 ## Run locally
 
-**We recommend using at least Deepseek 14B—smaller models struggle with tool use and memory retention.**
+**We recommend using at least Deepseek 14B, smaller models struggle with tool use and forget quickly the context.**
 
 ### 1️⃣ **Install Dependencies**  
 ```sh

From 8ed5fa7a35079f4354472ab95665af439d007d95 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Mon, 10 Mar 2025 14:41:07 +0100
Subject: [PATCH 07/32] Update README.md

---
 README.md | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 7850f88..75c0be1 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@
 
 ---
 
-## Run locally
+## Run locally on your machine
 
 **We recommend using at least Deepseek 14B, smaller models struggle with tool use and forget quickly the context.**
 
@@ -67,6 +67,8 @@ python3 main.py
 
 ## **Alternative: Run the LLM on your own server**  
 
+If you have a powerful computer or a server that you can use, but you want to use it from your laptop you have the options to run the LLM on a remote server. 
+
 ### 1️⃣  **Set up and start the server scripts** 
 
 On your "server" that will run the AI model, get the ip address
@@ -104,6 +106,26 @@ Run the assistant:
 python3 main.py
 ```
 
+## **Run with an API**  
+
+Clone the repository.
+
+Set the desired provider in the `config.ini`
+
+```sh
+[MAIN]
+is_local = False
+provider_name = openai
+provider_model = gpt4-o
+provider_server_address = 127.0.0.1:5000 # can be set to anything, not used
+```
+
+Run the assistant:
+
+```sh
+python3 main.py
+```
+
 ## Providers
 
 The table below show the available providers:

From 3a7f4cde10af293dcf178d6e8b280003995d5f02 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Mon, 10 Mar 2025 21:31:11 +0100
Subject: [PATCH 08/32] Update README.md

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 75c0be1..8533e92 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 
-# AgenticSeek: Local AI Assistant Powered by Deepseek R1 Agents.
+# AgenticSeek: Danus-like AI powered by Deepseek R1 Agents.
 
-**A fully local alternative to Manus AI**, a voice-enabled AI assistant that codes, explores your filesystem, and correct it's mistakes all without sending a byte of data to the cloud. The goal of the project is to create a truly Jarvis like assistant using reasoning model such as deepseek R1. 
+**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. The goal of the project is to create a truly Jarvis like assistant using reasoning model such as deepseek R1. 
 
 > 🛠️ **Work in Progress** – Looking for contributors! 🚀  
 

From 7babeb51e0cfe70b8b55631399b907a02ab9c352 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 09:47:55 +0100
Subject: [PATCH 09/32] Update issue templates

---
 .github/ISSUE_TEMPLATE/bug_report.md      | 38 +++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/feature_request.md | 20 ++++++++++++
 2 files changed, 58 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000..dd84ea7
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 0000000..bbcbbe7
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

From 1958cf14ea186e625fd38431458b518991689daf Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 09:48:52 +0100
Subject: [PATCH 10/32] Create CONTRIBUTING.md

---
 CONTRIBUTING.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..d4b720e
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,55 @@
+# Contributors guide
+
+## Prerequisites
+
+- Python 3.8 or higher
+- Ollama installed (for local model execution)
+- Basic familiarity with Python and AI models
+
+## Contribution Guidelines
+
+We welcome contributions in the following areas:
+
+- Code Improvements: Optimize existing code, fix bugs, or add new features.
+- Documentation: Improve the README, write tutorials, or add inline comments.
+- Testing: Write unit tests, integration tests, or help with debugging.
+- New Features: Implement new tools, agents, or integrations.
+
+## Steps to Contribute
+
+Fork the project to your GitHub account.
+
+Create a Branch:
+
+```bash
+git checkout -b feature/your-feature-name
+```
+
+Make Your Changes.
+
+Write your code, add documentation, or fix bugs.
+
+Test Your Changes.
+
+Ensure your changes work as expected and do not break existing functionality.
+
+Push your changes to your fork and submit a pull request to the main branch of this repository. Provide a clear description of your changes and reference any related issues.
+
+## Areas Needing Help
+
+Here are some high-priority tasks and areas where we need contributions:
+
+- Web Browsing: Implement autonomous web browsing capabilities for the assistant.
+- Multi-Agent System: Enhance the multi-agent functionality on the dev branch.
+- Memory & Recovery: Improve conversation compression.
+- New Tools: Add support for additional programming languages or APIs.
+- Testing: Write comprehensive tests for existing and new features.
+
+
+If you're unsure where to start, feel free to reach out by opening an issue or joining our community discussions.
+
+## Code of Conduct
+
+just be nice to each other.
+
+**Thank You!**

From fcc733886097c0062fbd6bd93d261dd9f5341ea2 Mon Sep 17 00:00:00 2001
From: martin legrand <martin.legrand@epitech.eu>
Date: Tue, 11 Mar 2025 09:50:01 +0100
Subject: [PATCH 11/32] Rm duplicate md file

---
 CONTRIBUTORS.md | 55 -------------------------------------------------
 1 file changed, 55 deletions(-)
 delete mode 100644 CONTRIBUTORS.md

diff --git a/CONTRIBUTORS.md b/CONTRIBUTORS.md
deleted file mode 100644
index a2e3d19..0000000
--- a/CONTRIBUTORS.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# Contributors guide
-
-## Prerequisites
-
-- Python 3.8 or higher
-- Ollama installed (for local model execution)
-- Basic familiarity with Python and AI models
-
-## Contribution Guidelines
-
-We welcome contributions in the following areas:
-
-- Code Improvements: Optimize existing code, fix bugs, or add new features.
-- Documentation: Improve the README, write tutorials, or add inline comments.
-- Testing: Write unit tests, integration tests, or help with debugging.
-- New Features: Implement new tools, agents, or integrations.
-
-## Steps to Contribute
-
-Fork the project to your GitHub account.
-
-Create a Branch:
-
-```bash
-git checkout -b feature/your-feature-name
-```
-
-Make Your Changes.
-
-Write your code, add documentation, or fix bugs.
-
-Test Your Changes.
-
-Ensure your changes work as expected and do not break existing functionality.
-
-Push your changes to your fork and submit a pull request to the main branch of this repository. Provide a clear description of your changes and reference any related issues.
-
-## Areas Needing Help
-
-Here are some high-priority tasks and areas where we need contributions:
-
-- Web Browsing: Implement autonomous web browsing capabilities for the assistant.
-- Multi-Agent System: Enhance the multi-agent functionality on the dev branch.
-- Memory & Recovery: Improve conversation compression.
-- New Tools: Add support for additional programming languages or APIs.
-- Testing: Write comprehensive tests for existing and new features.
-
-
-If you're unsure where to start, feel free to reach out by opening an issue or joining our community discussions.
-
-## Code of Conduct
-
-just be nice to each other.
-
-**Thank You!**
\ No newline at end of file

From c92714bde37f1930742ea07e0cc3dfc335a5f18a Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 09:50:39 +0100
Subject: [PATCH 12/32] Create CODE_OF_CONDUCT.md

---
 CODE_OF_CONDUCT.md | 128 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 128 insertions(+)
 create mode 100644 CODE_OF_CONDUCT.md

diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000..18c9147
--- /dev/null
+++ b/CODE_OF_CONDUCT.md
@@ -0,0 +1,128 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

From 8956ddadb87b26665738a8fc7421b2cfd71c23ea Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:05:03 +0100
Subject: [PATCH 13/32] Update README.md

---
 README.md | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 8533e92..19a6513 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,10 @@
 
 # AgenticSeek: Danus-like AI powered by Deepseek R1 Agents.
 
+![License](https://img.shields.io/badge/license-GPL--3.0-orange)
+
+![GitHub Issues](https://img.shields.io/github/issues/Fosowl/repository)
+
 **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. The goal of the project is to create a truly Jarvis like assistant using reasoning model such as deepseek R1. 
 
 > 🛠️ **Work in Progress** – Looking for contributors! 🚀  
@@ -180,9 +184,8 @@ we started this a fun side project to make a fully local, Jarvis-like AI. Howeve
 
 **Q: How is it better than manus or openManus ?**
 
-It's not, never will be, we just offer an alternative that is more local and enjoyable to use.
+It's not, our goal is just offer an alternative that is more local and enjoyable to use.
 
-## Current contributor:
-
-Fosowl 🇫🇷
-steveh8758 🇹🇼
+## Authors:
+ > [Fosowl](https://github.com/Fosowl) [name=Martin]
+ > [steveh8758](https://github.com/steveh8758) 

From 7d3ed23229d48f08c08669257946e6a3e149c2c0 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:05:27 +0100
Subject: [PATCH 14/32] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 19a6513..5c9052f 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
 
 ![License](https://img.shields.io/badge/license-GPL--3.0-orange)
 
-![GitHub Issues](https://img.shields.io/github/issues/Fosowl/repository)
+![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek)
 
 **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. The goal of the project is to create a truly Jarvis like assistant using reasoning model such as deepseek R1. 
 

From 223bed31689aa7b9e7cf9bb76e8e849b9ee2bad8 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:06:13 +0100
Subject: [PATCH 15/32] Update README.md

---
 README.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 5c9052f..db5cffb 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,8 @@
 
 # AgenticSeek: Danus-like AI powered by Deepseek R1 Agents.
 
-![License](https://img.shields.io/badge/license-GPL--3.0-orange)
+![License](https://img.shields.io/badge/license-GPL--3.0-orange) | ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek)
 
-![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek)
 
 **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. The goal of the project is to create a truly Jarvis like assistant using reasoning model such as deepseek R1. 
 

From d8e9a47142aff3c08e07ac18a6f13adc5ab13b47 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:06:22 +0100
Subject: [PATCH 16/32] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index db5cffb..a6f7ba1 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 
 # AgenticSeek: Danus-like AI powered by Deepseek R1 Agents.
 
-![License](https://img.shields.io/badge/license-GPL--3.0-orange) | ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek)
+![License](https://img.shields.io/badge/license-GPL--3.0-orange) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek)
 
 
 **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. The goal of the project is to create a truly Jarvis like assistant using reasoning model such as deepseek R1. 

From 7396d3cd2a9e197a9eaed32338c6cbdc87620651 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:07:57 +0100
Subject: [PATCH 17/32] Update README.md

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index a6f7ba1..d0d113b 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,6 @@
 
 # AgenticSeek: Danus-like AI powered by Deepseek R1 Agents.
 
-![License](https://img.shields.io/badge/license-GPL--3.0-orange) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek)
-
 
 **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. The goal of the project is to create a truly Jarvis like assistant using reasoning model such as deepseek R1. 
 
@@ -10,6 +8,8 @@
 
 ![alt text](./exemples/whale_readme.jpg)
 
+
+![License](https://img.shields.io/badge/license-GPL--3.0-green) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek) ![Discord](https://img.shields.io/badge/twitter-follow-blue?logo=twitter)
 ---
 
 ## Features:

From 939f84c7fbb155435887159be8f7b3b92be19c36 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:12:00 +0100
Subject: [PATCH 18/32] Update README.md

---
 README.md | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index d0d113b..049093b 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@
 ![alt text](./exemples/whale_readme.jpg)
 
 
-![License](https://img.shields.io/badge/license-GPL--3.0-green) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek) ![Discord](https://img.shields.io/badge/twitter-follow-blue?logo=twitter)
+![License](https://img.shields.io/badge/license-GPL--3.0-green) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek) ![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white)
 ---
 
 ## Features:
@@ -167,21 +167,25 @@ The 32B model needs a GPU with 24GB+ VRAM.
 
 **Q: Why Deepseek R1 over other models?**  
 
-Deepseek R1 excels at reasoning and tool use for its size. We think it’s a solid fit for our needs—other models work fine, but Deepseek is our primary pick.
+Deepseek R1 excels at reasoning and tool use for its size. We think it’s a solid fit for our needs other models work fine, but Deepseek is our primary pick.
 
 **Q: I get an error running `main.py`. What do I do?**  
 
 Ensure Ollama is running (`ollama serve`), your `config.ini` matches your provider, and dependencies are installed. If none work feel free to raise an issue.
 
+**Q: How to join the discord ?**
+
+Please ask in the community section and you will be approved.
+
 **Q: Can it really run 100% locally?**  
 
-Yes with Ollama or Server providers, all speech to text, LLM and text to speech model run locally. Non-local options (OpenAI, Deepseek API) are optional.
+Yes with Ollama or Server providers, all speech to text, LLM and text to speech model run locally. Non-local options (OpenAI or others API) are optional.
 
 **Q: How come it is older than manus ?**
 
-we started this a fun side project to make a fully local, Jarvis-like AI. However, with the rise of Manus and openManus, we saw the opportunity to redirected some tasks priority to make yet another alternative.
+we started this a fun side project to make a fully local, Jarvis-like AI. However, with the rise of Manus, we saw the opportunity to redirected some tasks priority to make yet another alternative.
 
-**Q: How is it better than manus or openManus ?**
+**Q: How is it better than manus  ?**
 
 It's not, our goal is just offer an alternative that is more local and enjoyable to use.
 

From b7a55c4e1a1f98ed55ca2cce7a45e5cd70f3a544 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:13:15 +0100
Subject: [PATCH 19/32] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 049093b..e3bc682 100644
--- a/README.md
+++ b/README.md
@@ -190,5 +190,5 @@ we started this a fun side project to make a fully local, Jarvis-like AI. Howeve
 It's not, our goal is just offer an alternative that is more local and enjoyable to use.
 
 ## Authors:
- > [Fosowl](https://github.com/Fosowl) [name=Martin]
+ > [Fosowl](https://github.com/Fosowl)
  > [steveh8758](https://github.com/steveh8758) 

From d83fe45fb02054bc89d935cd7046ae1fdef3ffac Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:26:59 +0100
Subject: [PATCH 20/32] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e3bc682..05e1d71 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
 
-# AgenticSeek: Danus-like AI powered by Deepseek R1 Agents.
+# AgenticSeek: Manus-like AI powered by Deepseek R1 Agents.
 
 
 **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. The goal of the project is to create a truly Jarvis like assistant using reasoning model such as deepseek R1. 

From e1cb1b1306ceef9441b220785e06e7550e9be318 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:28:22 +0100
Subject: [PATCH 21/32] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 05e1d71..44e3eb2 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@
 ![alt text](./exemples/whale_readme.jpg)
 
 
-![License](https://img.shields.io/badge/license-GPL--3.0-green) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek) ![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white)
+![License](https://img.shields.io/badge/license-GPL--3.0-green) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek) ![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white) [Website](https://fosowl.github.io/agenticSeek.html)
 ---
 
 ## Features:

From 4597f1016ea3c4e850e1c7114d63f7e7d2996e28 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:34:23 +0100
Subject: [PATCH 22/32] Update README.md

---
 README.md | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 44e3eb2..3b24ee4 100644
--- a/README.md
+++ b/README.md
@@ -9,21 +9,24 @@
 ![alt text](./exemples/whale_readme.jpg)
 
 
-![License](https://img.shields.io/badge/license-GPL--3.0-green) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek) ![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white) [Website](https://fosowl.github.io/agenticSeek.html)
+![License](https://img.shields.io/badge/license-GPL--3.0-green) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek) ![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white)
+
+[Website](https://fosowl.github.io/agenticSeek.html)
+
 ---
 
 ## Features:
 
-- **Privacy-first**: Runs 100% locally – **no data leaves your machine**  
-- ️**Voice-enabled**: Speak and interact naturally
-- **Filesystem interaction**: Use bash to interact with your filesystem.
-- **Coding abilities**: Code in Python, C, Golang, and soon more
-- **Trial-and-error**: If a command or code fails, the assistant retries to fixes it automatically, saving you time.
-- **Agent routing**: Select the best agent for the task.
-- **Multi-agent planning**: For complex tasks, divide and conquer with multiple agents
-- **Tools:**: All agents have their respective tools ability. Basic search, flight API, files explorer, etc...
-- **Web browsing (Not implemented yet)**: Browse the web autonomously to conduct task.
-- **Memory**: Retain only useful information, recover conversation session, remember your preferences.
+100% Local, 100% Private: No cloud, runs on your hardware. Your data stays yours.
+Talk to It: Voice-enabled interact naturally with speech to text and text to speech.
+Filesystem interaction: Use bash to navigate and manipulate your files effortlessly.
+Code like a Pro: Can write, debug, and run code in Python, C, Golang—with more languages on the way.
+Self-Correcting: If a command flops or code breaks, it retries and fixes itself.
+Agentic routing: Automatically picks the right agent for the job.
+Divide and Conquer: For big tasks, spins up multiple agents to plan and execute.
+Tool-Equipped: From basic search to flight APIs and file exploration, every agent has it's own tools.
+Memory That Matters: Remembers what’s useful, your preferences and past sessions conversation.
+Web Browsing: Autonomous web navigation is underway. (Under development)
 
 ---
 

From 9b0f17776345903e8fadef45f1c6e78329b9c169 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:36:37 +0100
Subject: [PATCH 23/32] Update README.md

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 3b24ee4..cf59e21 100644
--- a/README.md
+++ b/README.md
@@ -186,11 +186,11 @@ Yes with Ollama or Server providers, all speech to text, LLM and text to speech
 
 **Q: How come it is older than manus ?**
 
-we started this a fun side project to make a fully local, Jarvis-like AI. However, with the rise of Manus, we saw the opportunity to redirected some tasks priority to make yet another alternative.
+we started this a fun side project to make a fully local, Jarvis-like AI. However, with the rise of Manus, we saw the opportunity to redirected some tasks to make yet another alternative.
 
 **Q: How is it better than manus  ?**
 
-It's not, our goal is just offer an alternative that is more local and enjoyable to use.
+It's not, this is just a fun project, but it run locally and show that it's not rocket science to make hyped AI agents.
 
 ## Authors:
  > [Fosowl](https://github.com/Fosowl)

From bf96965d89ec7bd2730944b4eed59df3362cd5ee Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:37:33 +0100
Subject: [PATCH 24/32] Update README.md

---
 README.md | 28 ++++++++++++++++++----------
 1 file changed, 18 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index cf59e21..c335d26 100644
--- a/README.md
+++ b/README.md
@@ -16,17 +16,25 @@
 ---
 
 ## Features:
+- 100% Local, 100% Private: No cloud, runs on your hardware. Your data stays yours.
 
-100% Local, 100% Private: No cloud, runs on your hardware. Your data stays yours.
-Talk to It: Voice-enabled interact naturally with speech to text and text to speech.
-Filesystem interaction: Use bash to navigate and manipulate your files effortlessly.
-Code like a Pro: Can write, debug, and run code in Python, C, Golang—with more languages on the way.
-Self-Correcting: If a command flops or code breaks, it retries and fixes itself.
-Agentic routing: Automatically picks the right agent for the job.
-Divide and Conquer: For big tasks, spins up multiple agents to plan and execute.
-Tool-Equipped: From basic search to flight APIs and file exploration, every agent has it's own tools.
-Memory That Matters: Remembers what’s useful, your preferences and past sessions conversation.
-Web Browsing: Autonomous web navigation is underway. (Under development)
+- Talk to It: Voice-enabled interact naturally with speech to text and text to speech.
+
+- Filesystem interaction: Use bash to navigate and manipulate your files effortlessly.
+
+- Code like a Pro: Can write, debug, and run code in Python, C, Golang—with more languages on the way.
+
+- Self-Correcting: If a command flops or code breaks, it retries and fixes itself.
+
+- Agentic routing: Automatically picks the right agent for the job.
+
+- Divide and Conquer: For big tasks, spins up multiple agents to plan and execute.
+
+- Tool-Equipped: From basic search to flight APIs and file exploration, every agent has it's own tools.
+
+- Memory That Matters: Remembers what’s useful, your preferences and past sessions conversation.
+
+- Web Browsing: Autonomous web navigation is underway. (Under development)
 
 ---
 

From 0e69086877bf0800a6e2132628abc5dd5c47fc26 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:40:12 +0100
Subject: [PATCH 25/32] Update README.md

---
 README.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index c335d26..8e0b4ab 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 # AgenticSeek: Manus-like AI powered by Deepseek R1 Agents.
 
 
-**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. The goal of the project is to create a truly Jarvis like assistant using reasoning model such as deepseek R1. 
+**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. The goal of the project is to create an autonomous agent like Manus but using reasoning model such as deepseek R1, all running locally.
 
 > 🛠️ **Work in Progress** – Looking for contributors! 🚀  
 
@@ -16,23 +16,23 @@
 ---
 
 ## Features:
-- 100% Local, 100% Private: No cloud, runs on your hardware. Your data stays yours.
+- 100% Local: No cloud, runs on your hardware. Your data stays yours.
 
-- Talk to It: Voice-enabled interact naturally with speech to text and text to speech.
+- Voice interaction: Voice-enabled natural interaction.
 
 - Filesystem interaction: Use bash to navigate and manipulate your files effortlessly.
 
-- Code like a Pro: Can write, debug, and run code in Python, C, Golang—with more languages on the way.
+- Code what you ask: Can write, debug, and run code in Python, C, Golang and more languages on the way.
 
-- Self-Correcting: If a command flops or code breaks, it retries and fixes itself.
+- Self-Correcting: If a command flops or code breaks, it retries and fixes it by itself.
 
-- Agentic routing: Automatically picks the right agent for the job.
+- Agent routing: Automatically picks the right agent for the job.
 
 - Divide and Conquer: For big tasks, spins up multiple agents to plan and execute.
 
 - Tool-Equipped: From basic search to flight APIs and file exploration, every agent has it's own tools.
 
-- Memory That Matters: Remembers what’s useful, your preferences and past sessions conversation.
+- Memory: Remembers what’s useful, your preferences and past sessions conversation.
 
 - Web Browsing: Autonomous web navigation is underway. (Under development)
 

From 3842d79ead6bc7a5ede208fe5659a4b8081d84a5 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 10:48:15 +0100
Subject: [PATCH 26/32] Update CONTRIBUTING.md

---
 CONTRIBUTING.md | 37 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d4b720e..7289abc 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -35,6 +35,41 @@ Ensure your changes work as expected and do not break existing functionality.
 
 Push your changes to your fork and submit a pull request to the main branch of this repository. Provide a clear description of your changes and reference any related issues.
 
+## Coding Philosophy
+
+1. **Privacy First, Always Local**
+   - All core functionality must be able to run 100% locally
+   - Cloud services should only be optional alternatives, clearly defined with a warning message.
+   - User data privacy is non-negotiable
+
+2. **Agent-Based Architecture**
+   - Each agent should have a clear, single responsibility
+   - Agents should be modular and independently testable
+   - New agents should solve specific use cases
+
+3. **Tool-Based Extensibility**
+   - Tools should be self-contained and follow the Tools base class
+   - Each tool should do one thing well
+   - Tools should provide clear feedback on success/failure
+
+4. **User Experience**
+   - Provide meaningful feedback for all operations
+   - Support multiple languages (chinese, french, english for now)
+   - Text to speech with short response.
+   - Keep responses concise
+
+5. **Code Quality**
+   - Write clear, self-documenting code
+   - Include type hints and docstrings
+   - Follow existing patterns in the codebase
+   - Add a if __name__ == "__main__" at the bottom of each class file for individual testing.
+   - Ideally had automated tests.
+
+6. **Error Handling**
+   - Fail gracefully with meaningful messages
+   - Include recovery mechanisms where possible
+   - Log errors appropriately without exposing sensitive data
+
 ## Areas Needing Help
 
 Here are some high-priority tasks and areas where we need contributions:
@@ -50,6 +85,6 @@ If you're unsure where to start, feel free to reach out by opening an issue or j
 
 ## Code of Conduct
 
-just be nice to each other.
+See CODE_OF_CONDUCT.md
 
 **Thank You!**

From c33d14879dd24683f2e5529796e5946314e5d0e2 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 11:01:02 +0100
Subject: [PATCH 27/32] Update README.md

---
 README.md | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 8e0b4ab..9aa5320 100644
--- a/README.md
+++ b/README.md
@@ -4,37 +4,36 @@
 
 **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. The goal of the project is to create an autonomous agent like Manus but using reasoning model such as deepseek R1, all running locally.
 
-> 🛠️ **Work in Progress** – Looking for contributors! 🚀  
+> 🛠️ **Work in Progress** – Looking for contributors!
 
 ![alt text](./exemples/whale_readme.jpg)
 
 
-![License](https://img.shields.io/badge/license-GPL--3.0-green) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek) ![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) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek) ![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white)
 
-[Website](https://fosowl.github.io/agenticSeek.html)
 
 ---
 
 ## Features:
-- 100% Local: No cloud, runs on your hardware. Your data stays yours.
+- **100% Local**: No cloud, runs on your hardware. Your data stays yours.
 
-- Voice interaction: Voice-enabled natural interaction.
+- **Voice interaction**: Voice-enabled natural interaction.
 
-- Filesystem interaction: Use bash to navigate and manipulate your files effortlessly.
+- **Filesystem interaction**: Use bash to navigate and manipulate your files effortlessly.
 
-- Code what you ask: Can write, debug, and run code in Python, C, Golang and more languages on the way.
+- **Code what you ask**: Can write, debug, and run code in Python, C, Golang and more languages on the way.
 
-- Self-Correcting: If a command flops or code breaks, it retries and fixes it by itself.
+- **Autonomous**: If a command flops or code breaks, it retries and fixes it by itself.
 
-- Agent routing: Automatically picks the right agent for the job.
+- **Agent routing**: Automatically picks the right agent for the job.
 
-- Divide and Conquer: For big tasks, spins up multiple agents to plan and execute.
+- **Divide and Conquer**: For big tasks, spins up multiple agents to plan and execute.
 
-- Tool-Equipped: From basic search to flight APIs and file exploration, every agent has it's own tools.
+- **Tool-Equipped**: From basic search to flight APIs and file exploration, every agent has it's own tools.
 
-- Memory: Remembers what’s useful, your preferences and past sessions conversation.
+- **Memory**: Remembers what’s useful, your preferences and past sessions conversation.
 
-- Web Browsing: Autonomous web navigation is underway. (Under development)
+- **Web Browsing**: Autonomous web navigation is underway. (Under development)
 
 ---
 

From c1cac659b4f56a09a4219913472d806e33d29e8a Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 12:51:35 +0100
Subject: [PATCH 28/32] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9aa5320..f8b1ad1 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
 
 > 🛠️ **Work in Progress** – Looking for contributors!
 
-![alt text](./exemples/whale_readme.jpg)
+![alt text](./media/whale_readme.jpg)
 
 
 [![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) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek) ![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white)

From 685e09710c3ee88220d97415da99e72d3f821221 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 13:15:49 +0100
Subject: [PATCH 29/32] Update README.md

---
 README.md | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index f8b1ad1..4c35c06 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 # AgenticSeek: Manus-like AI powered by Deepseek R1 Agents.
 
 
-**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. The goal of the project is to create an autonomous agent like Manus but using reasoning model such as deepseek R1, all running locally.
+**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.
 
 > 🛠️ **Work in Progress** – Looking for contributors!
 
@@ -171,9 +171,9 @@ provider_server_address = 127.0.0.1:5000
 ## FAQ
 **Q: What hardware do I need?**  
 
-For Deepseek R1 7B, we recommend a  GPU with with 8GB VRAM.
-The 14B model can run on 12GB GPU like the rtx 3060.
-The 32B model needs a GPU with 24GB+ VRAM.
+7B Model: GPU with 8GB VRAM.
+14B Model: 12GB GPU (e.g., RTX 3060).
+32B Model: 24GB+ VRAM.
 
 **Q: Why Deepseek R1 over other models?**  
 
@@ -185,7 +185,7 @@ Ensure Ollama is running (`ollama serve`), your `config.ini` matches your provid
 
 **Q: How to join the discord ?**
 
-Please ask in the community section and you will be approved.
+Ask in the Community section for an invite.
 
 **Q: Can it really run 100% locally?**  
 
@@ -197,7 +197,10 @@ we started this a fun side project to make a fully local, Jarvis-like AI. Howeve
 
 **Q: How is it better than manus  ?**
 
-It's not, this is just a fun project, but it run locally and show that it's not rocket science to make hyped AI agents.
+It's not but we prioritizes local execution and privacy over cloud based approach. It’s a fun, accessible alternative!
+
+Contribute
+We’re looking for developers to enhance AgenticSeek! Check out open issues or join our Discord to collaborate.
 
 ## Authors:
  > [Fosowl](https://github.com/Fosowl)

From 1433aa50aa7f30c57d42a6a2a219d83bb3d85086 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 14:48:36 +0100
Subject: [PATCH 30/32] Update README.md

---
 README.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 4c35c06..9296482 100644
--- a/README.md
+++ b/README.md
@@ -199,8 +199,9 @@ we started this a fun side project to make a fully local, Jarvis-like AI. Howeve
 
 It's not but we prioritizes local execution and privacy over cloud based approach. It’s a fun, accessible alternative!
 
-Contribute
-We’re looking for developers to enhance AgenticSeek! Check out open issues or join our Discord to collaborate.
+## Contribute
+
+We’re looking for developers to improve AgenticSeek! Check out open issues or discussion.
 
 ## Authors:
  > [Fosowl](https://github.com/Fosowl)

From b114cc8cdc13ec098be41c347216b5e7f323b8c4 Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Tue, 11 Mar 2025 18:40:20 +0100
Subject: [PATCH 31/32] Update README.md

---
 README.md | 41 +++++++++++++++++++++++++++++++----------
 1 file changed, 31 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 9296482..84d36e7 100644
--- a/README.md
+++ b/README.md
@@ -4,17 +4,15 @@
 
 **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)
 > 🛠️ **Work in Progress** – Looking for contributors!
 
 ![alt text](./media/whale_readme.jpg)
 
 
-[![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) ![GitHub Issues](https://img.shields.io/github/issues/Fosowl/agenticSeek) ![Discord](https://img.shields.io/badge/Discord-Join%20Us-7289DA?logo=discord&logoColor=white)
-
-
----
 
 ## Features:
+
 - **100% Local**: No cloud, runs on your hardware. Your data stays yours.
 
 - **Voice interaction**: Voice-enabled natural interaction.
@@ -37,16 +35,33 @@
 
 ---
 
-## Run locally on your machine
+## **Installation**
 
-**We recommend using at least Deepseek 14B, smaller models struggle with tool use and forget quickly the context.**
+### 1️⃣ **Clone the repository**
+
+```sh
+git clone https://github.com/Fosowl/agenticSeek.git
+cd agenticSeek
+```
+
+### 2️ **Create a virtual env**
+
+```sh
+python3 -m venv agentic_seek_env
+source agentic_seek_env/bin/activate      # On Windows: agentic_seek_env\Scripts\activate
+```
+
+### 3️⃣ **Install Dependencies**
 
-### 1️⃣ **Install Dependencies**  
 ```sh
 pip3 install -r requirements.txt
 ```
 
-### 2️⃣ **Download Models**  
+## Run locally on your machine
+
+**We recommend using at least Deepseek 14B, smaller models struggle with tool use and forget quickly the context.**
+
+### 1️⃣ **Download Models**  
 
 Make sure you have [Ollama](https://ollama.com/) installed.
 
@@ -56,7 +71,7 @@ Download the `deepseek-r1:7b` model from [DeepSeek](https://deepseek.com/models)
 ollama pull deepseek-r1:7b
 ```
 
-### 3️⃣ **Run the Assistant (Ollama)**  
+### 2️ **Run the Assistant (Ollama)**  
 
 Start the ollama server
 ```sh
@@ -78,7 +93,9 @@ Run the assistant:
 python3 main.py
 ```
 
-## **Alternative: Run the LLM on your own server**  
+---
+
+## **Run the LLM on your own server**  
 
 If you have a powerful computer or a server that you can use, but you want to use it from your laptop you have the options to run the LLM on a remote server. 
 
@@ -90,6 +107,8 @@ On your "server" that will run the AI model, get the ip address
 ip a | grep "inet " | grep -v 127.0.0.1 | awk '{print $2}' | cut -d/ -f1
 ```
 
+Note: For Windows or macOS, use ipconfig or ifconfig respectively to find the IP address.
+
 Clone the repository and then, run the script `stream_llm.py` in `server/`
 
 ```sh
@@ -139,6 +158,8 @@ Run the assistant:
 python3 main.py
 ```
 
+---
+
 ## Providers
 
 The table below show the available providers:

From e05c57043ddc54e8773ef81ad4f23921ae82e33d Mon Sep 17 00:00:00 2001
From: Martin <49105846+Fosowl@users.noreply.github.com>
Date: Wed, 12 Mar 2025 13:54:20 +0100
Subject: [PATCH 32/32] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 84d36e7..4b92763 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@
 
 - **Memory**: Remembers what’s useful, your preferences and past sessions conversation.
 
-- **Web Browsing**: Autonomous web navigation is underway. (Under development)
+- **Web Browsing**: Autonomous web navigation is underway. (See it on browser branch)
 
 ---