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

> Source: <https://git.cerberusgames.ca/Starstreak/PurgeHound/>
> Published: 2026-08-18 07:26:25+00:00

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
```