2025-03-11 10:37:33 +01:00
2025-03-10 14:34:48 +01:00
2025-03-07 13:59:57 +01:00
2025-03-10 10:37:39 +01:00
2025-03-11 09:50:39 +01:00
2025-03-10 13:43:25 +01:00
2025-03-11 09:48:52 +01:00
2025-03-11 10:37:33 +01:00
2025-03-07 20:35:43 +01:00

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.

🛠️ Work in Progress Looking for contributors! 🚀

alt text

License GitHub Issues Discord

Website


Features:

  • 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 whats useful, your preferences and past sessions conversation.

  • Web Browsing: Autonomous web navigation is underway. (Under development)


Run locally on your machine

We recommend using at least Deepseek 14B, smaller models struggle with tool use and forget quickly the context.

1 Install Dependencies

pip3 install -r requirements.txt

2 Download Models

Make sure you have Ollama installed.

Download the deepseek-r1:7b model from DeepSeek

ollama pull deepseek-r1:7b

3 Run the Assistant (Ollama)

Start the ollama server

ollama serve

Change the config.ini file to set the provider_name to ollama and provider_model to deepseek-r1:7b

[MAIN]
is_local = True
provider_name = ollama
provider_model = deepseek-r1:7b

Run the assistant:

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

ip a | grep "inet " | grep -v 127.0.0.1 | awk '{print $2}' | cut -d/ -f1

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.

Change the config.ini file to set the provider_name to server and provider_model to deepseek-r1:7b. Set the provider_server_address to the ip address of the machine that will run the model.

[MAIN]
is_local = False
provider_name = server
provider_model = deepseek-r1:14b
provider_server_address = x.x.x.x:5000

Run the assistant:

python3 main.py

Run with an API

Clone the repository.

Set the desired provider in the config.ini

[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:

python3 main.py

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:

is_local = False
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.

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_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 its 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 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, we saw the opportunity to redirected some tasks to make yet another alternative.

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.

Authors:

Fosowl steveh8758

Description
No description provided
Readme GPL-3.0
Languages
Python 86.8%
JavaScript 5.2%
Shell 3.6%
CSS 3%
Batchfile 1.1%
Other 0.2%