explaingit

nilsherzig/llocalsearch

5,955GoAudience · developerComplexity · 3/5Setup · moderate

TLDR

LLocalSearch is a locally-running AI search engine that lets you ask questions in plain English and get web-sourced answers, all without sending data to any external API. It uses AI agents and Ollama to run language models on your own computer.

Mindmap

mindmap
  root((repo))
    What it does
      Local AI web search
      Agent reasoning loop
      Show source steps
    Tech Stack
      Go
      Docker
      Ollama
    Use Cases
      Private web search
      Source-traced answers
      Local AI assistant
    Audience
      Privacy-focused users
      Developers
    Setup
      Docker required
      Ollama required
      Mid-range GPU
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Ask questions in plain English and get AI-generated answers sourced from the web, all running on your own computer without external APIs.

USE CASE 2

Run a private AI search system without sending any queries to Google, OpenAI, or other third-party services.

USE CASE 3

Trace how an AI agent searches the web step-by-step to see exactly which sources it consulted to build an answer.

USE CASE 4

Deploy a local alternative to commercial AI search tools on mid-range home hardware using Docker and Ollama.

Tech stack

GoDockerOllama

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Docker and Ollama installed locally, a mid-range GPU around 300 EUR is recommended for reasonable response speed.

In plain English

LLocalSearch is a locally-running search tool powered by small AI language models. It lets you ask a question in plain English, and the system uses AI agents to search the internet and compile an answer, all without sending data to OpenAI, Google, or any external API service. No API keys are required. The core idea is that a language model runs on your own computer and is given access to tools, including web search. The model reads your question, decides which tools to call, searches the web, reviews the results, and may search again based on what it finds. This cycle repeats until the model has enough information to answer. The interface shows each step as it happens, including the links and sources the agent consulted, so you can trace how the answer was formed. The project was motivated by concerns about commercial AI search products being shaped by paid partnerships with publishers. LLocalSearch runs on local hardware with no external service involved, so no third party can influence which sources appear or how they are ranked. Installation uses Docker. The system connects to Ollama, a tool for running language models on your own machine. The README notes the demo was recorded on hardware with a roughly 300 euro GPU, which the author frames as accessible to mid-range hardware rather than requiring a high-end setup. As of the most recent README update, active development on this version had paused for over a year. The author is working on a rewrite in a private beta and invited interested users to reach out to participate.

Copy-paste prompts

Prompt 1
Help me install LLocalSearch using Docker and connect it to Ollama so I can run private AI-powered web searches locally.
Prompt 2
How does LLocalSearch decide when to search the web again after reading initial results? Walk me through the agent reasoning loop.
Prompt 3
What GPU or hardware do I need to run LLocalSearch at a reasonable speed on a home computer?
Prompt 4
How do I configure which language model LLocalSearch uses through Ollama, can I swap in a smaller or larger model?
Prompt 5
How does LLocalSearch display the sources and step-by-step reasoning it used to form an answer?
Open on GitHub → Explain another repo

← nilsherzig on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.