Erases spam from your Maildir!
Find a file
2026-08-18 07:24:42 +00:00
go.mod Update go.mod 2026-08-18 07:14:29 +00:00
LICENSE Initial commit 2026-08-18 06:44:27 +00:00
logo.avif Upload files to "/" 2026-08-18 07:20:08 +00:00
logo.png Upload files to "/" 2026-08-18 07:20:08 +00:00
main.go Updated to be more parallel 2026-08-18 06:55:43 +00:00
README.md Update README.md 2026-08-18 07:24:42 +00:00

PurgeHound

Logo

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