gitwtfhub

wtf is agenttool?

aditya-an1l/agenttool — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 2/5LicenseSetup · moderate

TL;DR

A terminal coding assistant that auto-discovers local Ollama or LM Studio models and runs an agentic tool-calling loop with web search and file ops.

Mindmap

mindmap
  root((AgentTool))
    What it does
      Terminal coding assistant
      Auto-discovers local models
      Tool-calling loop
    Tech stack
      Python
      Ollama
      LM Studio
    Use cases
      Chat with local model
      Web search and file ops
      Test tool calling
    Audience
      Developers
    Tools
      web_search
      read_write_file
      run_command

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Chat with a fully local AI model from the terminal without needing a cloud API key.

REASON 2

Let the assistant search the web, read and write files, or run shell commands as part of a coding task.

REASON 3

Test tool-calling behavior against different local models served by Ollama or LM Studio.

What's in the stack?

PythonOllamaLM StudioRich

How it stacks up

aditya-an1l/agenttool0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity2/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a locally running Ollama or LM Studio server with a model already loaded before use.

Apache 2.0 license: use freely for any purpose, including commercial use, as long as you keep the copyright and license notices.

Wtf does this do

AgentTool is a lightweight Python command line assistant that connects to AI models running entirely on your own computer through Ollama or LM Studio, rather than a cloud service. It automatically finds any local model server you have running, presents an interactive menu so you can pick which model to use, and then starts a conversation loop where the model can call built-in tools to accomplish tasks. Once a model is selected, the assistant can search the web using DuckDuckGo, read and write files, list the contents of a directory, and execute shell commands, all as part of an automated back-and-forth loop between the model's requests and the tool results. The tool-calling format follows the same convention used by OpenAI's API, so it works with any local server that speaks that same protocol, and the project includes fallback parsing to handle models that occasionally produce a slightly malformed tool call. Installation follows a standard Python workflow: cloning the repository, setting up a virtual environment, and installing the listed dependencies along with a separate set of development dependencies for running the included test suite. To actually use the assistant, you first need a local inference server running, either by starting Ollama with a model already pulled or by opening LM Studio and loading a model there, then launching the script and selecting the desired model from the list. No real API key is needed since a placeholder key is used internally to satisfy the OpenAI-compatible request format, and the tool-calling loop is capped at ten iterations to prevent it from running indefinitely. The project also includes a comprehensive test suite and handles Ctrl+C interruptions gracefully so a running session can be stopped cleanly.

Yoink these prompts

Prompt 1
Set up AgentTool with a locally running Ollama model and walk me through picking it from the menu.
Prompt 2
Explain how AgentTool's fallback parsing handles models that produce malformed tool calls.
Prompt 3
Show me how the run_command and file read and write tools are implemented in this project.
Prompt 4
Help me add a new custom tool to AgentTool's agentic loop.

Frequently asked questions

wtf is agenttool?

A terminal coding assistant that auto-discovers local Ollama or LM Studio models and runs an agentic tool-calling loop with web search and file ops.

What language is agenttool written in?

Mainly Python. The stack also includes Python, Ollama, LM Studio.

What license does agenttool use?

Apache 2.0 license: use freely for any purpose, including commercial use, as long as you keep the copyright and license notices.

How hard is agenttool to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is agenttool for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.