From 12290eb1d7ba637499c107ffc7d4058794c9f2fa Mon Sep 17 00:00:00 2001 From: Martin <49105846+Fosowl@users.noreply.github.com> Date: Fri, 7 Mar 2025 15:19:07 +0100 Subject: [PATCH 1/8] Update README.md --- README.md | 18 +++--------------- 1 file changed, 3 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index e038ea4..b9dcf07 100644 --- a/README.md +++ b/README.md @@ -10,12 +10,14 @@ - **Privacy-first**: Runs 100% locally – **no data leaves your machine** - ️ **Voice-enabled**: Speak and interact naturally -- **Coding abilities**: Code in Python, Bash, C, Golang, and soon more +- - **Filesystem interaction**: Use bash to interact with your filesystem. +- **Coding abilities**: Code in Python, C, Golang, and soon more - **Trial-and-error**: Automatically fixes code or command upon execution failure - **Agent routing**: Select the best agent for the task - **Multi-agent**: 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&Recovery**: Compress conversation over time to retain usefull information, recover conversation session. --- @@ -122,17 +124,3 @@ provider_name: Select the provider to use by its name, see the provider list abo provider_model: Set the model to use by the agent. provider_server_address: can be set to anything if you are not using the server provider. - - -## Current capabilities - -- All running locally -- Reasoning with deepseek R1 -- Code execution capabilities (Python, Golang, C, etc..) -- Shell control capabilities in bash -- Will try to fix errors by itself -- Routing system, select the best agent for the task -- Fast text-to-speech using kokoro. -- Speech to text. -- Memory compression (reduce history as interaction progresses using summary model) -- Recovery: recover and save session from filesystem. From e5c5839d7e1588b3c723ec1491b6bf73f1d469cd Mon Sep 17 00:00:00 2001 From: Martin <49105846+Fosowl@users.noreply.github.com> Date: Fri, 7 Mar 2025 15:19:44 +0100 Subject: [PATCH 2/8] Update README.md --- README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index b9dcf07..283cda9 100644 --- a/README.md +++ b/README.md @@ -8,16 +8,16 @@ ## 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. +- **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**: Automatically fixes code or command upon execution failure +- **Trial-and-error**: Automatically fixes code or command upon execution failure - **Agent routing**: Select the best agent for the task - **Multi-agent**: 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&Recovery**: Compress conversation over time to retain usefull information, recover conversation session. +- **Web browsing (not implemented yet)**: Browse the web autonomously to conduct task. +- **Memory&Recovery**: Compress conversation over time to retain usefull information, recover conversation session. --- From 284fcfe29d9ad8a2bdf242545f118a757b41b9c2 Mon Sep 17 00:00:00 2001 From: Martin <49105846+Fosowl@users.noreply.github.com> Date: Sun, 9 Mar 2025 12:59:14 +0100 Subject: [PATCH 3/8] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 283cda9..2c36080 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ - **Agent routing**: Select the best agent for the task - **Multi-agent**: 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. +- **Web browsing (not implemented yet | Hight priority task)**: Browse the web autonomously to conduct task. - **Memory&Recovery**: Compress conversation over time to retain usefull information, recover conversation session. --- From 5c0376caf329a71362ac6f60096c3bc85f8e6580 Mon Sep 17 00:00:00 2001 From: Martin <49105846+Fosowl@users.noreply.github.com> Date: Sun, 9 Mar 2025 13:09:35 +0100 Subject: [PATCH 4/8] Update README.md --- README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 2c36080..32dc00e 100644 --- a/README.md +++ b/README.md @@ -21,12 +21,9 @@ --- +## Run locally - ---- - - -## Installation +**We recommand you use at least deepseek 14b, as smaller small will have trouble using tool and forget quickly the conversations.** ### 1️⃣ **Install Dependencies** ```sh @@ -65,8 +62,9 @@ Run the assistant: python3 main.py ``` -### 4️⃣ **Alternative: Run the LLM on your own server** +## **Alternative: Run the LLM on your own server** +### 1️⃣ **Set up and start the server scripts** On your "server" that will run the AI model, get the ip address @@ -80,6 +78,8 @@ Clone the repository and then, run the script `stream_llm.py` in `server/` python3 stream_llm.py ``` +### 2️⃣ **Run it** + Now on your personal computer: Clone the repository. From 073eebfd1786d59581efdd98f167bb1b484e511c Mon Sep 17 00:00:00 2001 From: Martin <49105846+Fosowl@users.noreply.github.com> Date: Sun, 9 Mar 2025 13:32:17 +0100 Subject: [PATCH 5/8] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 32dc00e..e8e84a2 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ - **Coding abilities**: Code in Python, C, Golang, and soon more - **Trial-and-error**: Automatically fixes code or command upon execution failure - **Agent routing**: Select the best agent for the task -- **Multi-agent**: For complex tasks, divide and conquer with multiple agents +- **Multi-agent (On Dev branch)**: 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 usefull information, recover conversation session. From a34256f6530fc2afbe1fcadae7cf9b79d56325a9 Mon Sep 17 00:00:00 2001 From: Martin <49105846+Fosowl@users.noreply.github.com> Date: Mon, 10 Mar 2025 10:17:32 +0100 Subject: [PATCH 6/8] Update README.md --- README.md | 27 +++++++++++++++++---------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index e8e84a2..b9da49d 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ -# AgenticSeek: Fully local AI Assistant Powered by Deepseek R1 Agents. +# AgenticSeek: Local AI Assistant Powered by Deepseek R1 Agents. -**A fully local AI assistant** using AI agents. 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, 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! 🚀 --- @@ -12,18 +12,18 @@ - ️**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**: Automatically fixes code or command upon execution failure +- **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 - **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 usefull information, recover conversation session. +- **Memory&Recovery**: Compress conversation over time to retain useful information, recover conversation session. --- ## Run locally -**We recommand you use at least deepseek 14b, as smaller small will have trouble using tool and forget quickly the conversations.** +**We recommend using at least Deepseek 14B—smaller models struggle with tool use and memory retention.** ### 1️⃣ **Install Dependencies** ```sh @@ -103,11 +103,18 @@ python3 main.py ## Provider -Currently the only provider are : -- ollama -> Use ollama running on your computer. Ollama program for running locally large language models. -- server -> A custom script that allow you to have the LLM model run on another machine. Currently it use ollama but we'll switch to other options soon. -- openai -> Use ChatGPT API (not private). -- deepseek -> Deepseek API (not private). +## Providers + +The table below show the available providers: + +| Provider | Local? | Description | +|-----------|--------|-----------------------------------------------------------| +| Ollama | Yes | Run LLMs locally with ease using ollama as a LLM provider | +| Server | Yes | Host the model on another machine, run your local machine | +| OpenAI | No | Use ChatGPT API (non-private) | +| Deepseek | No | Deepseek API (non-private) | +| HuggingFace| No | Hugging-Face API (non-private) | + To select a provider change the config.ini: From ded00bbced19de625bc9a9385c97672faa056c16 Mon Sep 17 00:00:00 2001 From: Martin <49105846+Fosowl@users.noreply.github.com> Date: Mon, 10 Mar 2025 10:24:17 +0100 Subject: [PATCH 7/8] Update README.md --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index b9da49d..bf7a7e1 100644 --- a/README.md +++ b/README.md @@ -124,10 +124,10 @@ provider_name = openai provider_model = gpt-4o provider_server_address = 127.0.0.1:5000 ``` -is_local: should be True for any locally running LLM, otherwise False. +`is_local`: should be True for any locally running LLM, otherwise False. -provider_name: Select the provider to use by its name, see the provider list above. +`provider_name`: Select the provider to use by its name, see the provider list above. -provider_model: Set the model to use by the agent. +`provider_model`: Set the model to use by the agent. -provider_server_address: can be set to anything if you are not using the server provider. +`provider_server_address`: can be set to anything if you are not using the server provider. From fe169b86d3a17693f883df778770dc9f6d4aa949 Mon Sep 17 00:00:00 2001 From: Martin <49105846+Fosowl@users.noreply.github.com> Date: Mon, 10 Mar 2025 10:30:48 +0100 Subject: [PATCH 8/8] Update README.md --- README.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index bf7a7e1..3f73061 100644 --- a/README.md +++ b/README.md @@ -101,8 +101,6 @@ Run the assistant: python3 main.py ``` -## Provider - ## Providers The table below show the available providers: @@ -131,3 +129,8 @@ provider_server_address = 127.0.0.1:5000 `provider_model`: Set the model to use by the agent. `provider_server_address`: can be set to anything if you are not using the server provider. + +## Current contributor: + +Fosowl 🇫🇷 +steveh8758 🇹🇼