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

QBasicBitch1 pts0 comments

Starstreak/PurgeHound: Erases spam from your Maildir! - Cerberus Games Git: Welcome to Cerberus Gaming - Fuck you, I'm coding

This website requires JavaScript.

Starstreak/PurgeHound

Watch

Star

Fork

You've already forked PurgeHound

Code

Issues

Pull requests

Projects

Releases

Packages

Wiki

Activity

Actions

Erases spam from your Maildir!

16 commits

1 branch

0 tags

424 KiB

Go

100%

main

Find a file

HTTPS

Download ZIP<br>Download TAR.GZ<br>Download BUNDLE

Open with VS Code

Open with VSCodium

Open with Intellij IDEA

Exact

Exact

Union

RegExp

Starstreak

b6c9418a76

Update README.md

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

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<br>Change directory

cd PurgeHound<br>Build the program.

go build .<br>Do you already have a model in mind that is installed? If so, skip this:

ollama pull gemma4<br>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]<br>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

purgehound maildir folder starstreak spam readme

Related Articles