explaingit

rahulaloth/goodle

Analysis updated 2026-05-18

2PythonAudience · generalComplexity · 2/5Setup · moderate

TLDR

A privacy-friendly local search tool that indexes a folder of PDFs, text files, Word docs, and images on your computer and lets you search them through a browser interface.

Mindmap

mindmap
  root((goodle))
    What it does
      Local file search
      Content inside images
      Browser interface
    Supported Files
      PDFs and text
      Word documents
      Images and CSV
    Setup
      Docker recommended
      Manual Python setup
      Change indexed folder
    Audience
      Students
      Office workers
      Note takers
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

What do people build with it?

USE CASE 1

Search a folder of PDFs, notes, and screenshots by keyword to find files you saved but cannot locate by name

USE CASE 2

Index a folder of meeting summaries and reference documents for instant full-text search

USE CASE 3

Run a private local search engine that works entirely without internet access

USE CASE 4

Find text inside images by running Goodle against a folder of screenshots

What is it built with?

PythonStreamlitDocker

How does it compare?

rahulaloth/goodle0-bingwu-0/live-interpreter0xkaz/llm-governance-dashboard
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity2/52/54/5
Audiencegeneralgeneralops devops

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker Desktop. The import/export feature fails on Windows due to Docker path format limitations.

In plain English

This is a lightweight local search tool that runs on your computer and lets you search through files in a folder you choose, without sending anything to the internet. It scans PDFs, text files, Word documents, images, and CSV files, then gives you a browser-based interface where you can type a keyword and instantly find matching content, even text inside images. The tool is built for people who save lots of files in one place and later struggle to find a specific note, screenshot, or reference document. Students, office workers, and anyone who accumulates files will recognize the problem: you saved something but cannot remember the filename. Goodle indexes the folder and lets you search by content rather than filename. The recommended way to run it is through Docker, a tool for running software in an isolated container. You pull the Goodle image, point it at your folder, and open a browser to a local address. No Python installation is required if you use Docker. For those who want to modify or develop the app, a manual setup path is also available: clone the repository, install Python dependencies, and run the Streamlit app directly. Supported file types include PDFs, plain text files, Markdown files, Word documents, images (PNG and JPG), and CSV files. Excel spreadsheets are intentionally not recommended because they contain structured data rather than plain text. The folder being indexed can be changed at any time by adjusting the Docker volume mount or pressing a Re-Index button in the interface. The project is described as intentionally simple so others can build on top of it. Planned future improvements include faster indexing, more file types, better ranking, and a plugin system. There is a known issue where the import and export feature fails on Windows due to how Docker handles file paths on that platform.

Copy-paste prompts

Prompt 1
Help me run Goodle with Docker on Windows 11 to index my D:/Documents folder and search through all my PDFs and notes.
Prompt 2
Write a docker-compose.yml for Goodle that mounts my /home/user/notes folder and runs on port 8600.
Prompt 3
I want to add support for indexing PowerPoint files in Goodle. Walk me through modifying goodle_core.py to handle .pptx files.
Prompt 4
Help me set up Goodle without Docker by running it directly with pip install and streamlit on macOS.
Prompt 5
I'm getting a path error with Goodle's import/export on Windows. How do Docker Windows volume paths work and how do I fix this?

Frequently asked questions

What is goodle?

A privacy-friendly local search tool that indexes a folder of PDFs, text files, Word docs, and images on your computer and lets you search them through a browser interface.

What language is goodle written in?

Mainly Python. The stack also includes Python, Streamlit, Docker.

How hard is goodle to set up?

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

Who is goodle for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub rahulaloth on gitmyhub

Verify against the repo before relying on details.