Developers

SpamFoo installs alongside your existing mail server or messaging platform. Native integrations, flexible deployment modes, and API access mean you can be up and running without rearchitecting anything.

Deployment Modes

Daemon Mode

The default for production. SpamFoo runs as a background service on your mail server, classifying emails in real time through a local API. Persistent caching means repeat senders are handled instantly.

Runs as a systemd unit or Windows Service.

CLI Mode

Point it at an .eml file, get a JSON classification back. Useful for testing, scripting, or one-off analysis before you commit to a full deployment.

No persistent state or background process required.

Directory Watcher

For mail servers that can drop .eml files into a folder. SpamFoo watches the directory, classifies each message, and writes results back. Works with any server that supports a delivery delay or queue directory.

Configurable polling interval and output format.

API Access

Build your own integration or extend SpamFoo with our REST API.

REST API

Standard HTTP/JSON API for easy integration.

POST /api/v1/classify
Content-Type: application/json
Authorization: Bearer <api-key>

{
  "email": "base64_encoded_eml",
  "options": {
    ...
  }
}

View Our Documentation