PurgeHound – Use the power of local LLM to declutter a Maildir folder

PurgeHound, an open-source tool from Starstreak, uses local large language models to declutter Maildir folders by moving spam messages to an Archive-Spam folder, with nothing deleted. The tool, built in Go, supports models like gemma4 via Ollama and recommends a single worker for normal use, though it has been tested with two workers on an AMD 6800 XT.

Erases spam from your Maildir - Go 100% | | LICENSE /Starstreak/PurgeHound/src/branch/main/LICENSE logo.avif /Starstreak/PurgeHound/src/branch/main/logo.avif logo.png /Starstreak/PurgeHound/src/branch/main/logo.png main.go /Starstreak/PurgeHound/src/branch/main/main.go README.md /Starstreak/PurgeHound/src/branch/main/README.md PurgeHound Description Use the power of LLM to declutter your Maildir folder Using this tool will move messaged marked as spam into a new folder: Archive-Spam. Nothing is deleted, but you are free to delete that folder when its finished. Installation Grab the source code. git clone https://git.cerberusgames.ca/Starstreak/PurgeHound.git Change directory cd PurgeHound Build the program. go build . Do you already have a model in mind that is installed? If so, skip this: ollama pull gemma4 Usage Normal users should be using -workers 1 unless you have a reason to use more. You'll know if you need it. Usage: spamGPT -maildir /path/to/maildir -ollama-url URL -model MODEL -workers 2 -timeout 5m I did try workers 2 on a 6800 XT and it did not blow up with gemma4. Quickstart If all else fails -maildir is the directory for your database ./PurgeHound -model gemma4 -maildir gmail/ -workers 1