FreeStarting price
0Popularity
higgs featured image

About higgs

higgs is a command-line interface that enables AI-driven processing of Proton Mail messages entirely on the user’s local machine. It integrates with Proton Mail Bridge to read encrypted emails via localhost, ensuring no data is transmitted to external servers. The tool leverages a self-hosted large language model, such as those supported by Ollama or any OpenAI-compatible server like llama.cpp, to perform tasks like classification, search, summarization, and question answering. By operating locally, higgs maintains full data privacy while providing structured NDJSON output for downstream automation and agentic workflows. It is designed for technical users who prefer typed commands, exit codes, and a discoverable schema, eliminating the need for prompt engineering or heuristic parsing. The tool supports piping between commands and integrates with the operating system’s keyring for secure credential storage. higgs is particularly suited for users who require secure, offline processing of sensitive email data while benefiting from AI capabilities. Its architecture prioritizes automation, reproducibility, and control over the entire processing pipeline.

Key features

  • Classifies messages into labels with confidence scores
  • Searches mail by date, folder, or text using local LLM
  • Generates summaries of conversations or threads
  • Answers questions about mail content locally
  • Pipes structured output between commands
  • Supports dry-run mode for testing
  • Integrates with OS keyring for credential storage
  • Provides typed error handling with exit codes

Use cases

  • Automate email categorization and archiving
  • Locate specific messages or receipts without cloud search
  • Generate summaries of long email threads for quick review

Pros

  • Local processing with no cloud inference or API keys
  • Structured NDJSON output for reliable piping and automation
  • Discoverable schema for every command and flag
  • Uses Proton Mail Bridge for secure local mail access
  • Open source with zero telemetry and signed releases

Cons

  • Requires local model hosting (e.g., Ollama or llama.cpp)
  • Limited to Proton Mail users via Proton Mail Bridge
  • No graphical user interface

Frequently asked questions about higgs

What is higgs and what does it do?

higgs is a local-first command-line interface that integrates with Proton Mail Bridge to provide AI-driven classification, search, summarization, and question answering directly on the user’s machine. It processes encrypted mail locally using a self-hosted large language model, ensuring no data leaves the user’s hardware.

Who is higgs designed for?

higgs is designed for users who prioritize privacy and want to leverage AI for email management without relying on cloud services. It is particularly suitable for developers, privacy-conscious individuals, and organizations using Proton Mail.

How does higgs ensure privacy?

higgs ensures privacy by processing all email data locally through Proton Mail Bridge and a self-hosted LLM. It does not send any content to external servers, uses OS keyring for credential storage, and is open-source with zero telemetry.

What models or backends does higgs support?

higgs supports local large language models via Ollama by default or any OpenAI-compatible server like llama.cpp. Users can configure the backend to suit their hardware and preferences.

Can higgs be used with other email providers besides Proton Mail?

No, higgs is specifically designed to work with Proton Mail Bridge, which provides the local IMAP interface for encrypted email access. It does not support other email providers.

How do I get started with higgs?

To get started, install higgs via Homebrew, Go, or release tarballs. Configure Proton Mail Bridge and a local LLM backend like Ollama. Then use the CLI commands to classify, search, or summarize emails directly from your terminal.

higgs compared

Reviews