davidnorth/clearmail

Node.js API

6 environment variables found in .env.example

Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow.

PROVIDER_BASE_URL LLM Provider (OpenAI-compatible) DeepSeek is the default — cheap, capable, OpenAI-compatible API. To use OpenAI directly, change baseURL to…
PROVIDER_API_KEY secret
PROVIDER_MODEL
GOOGLE_CLIENT_ID Google OAuth2 (Gmail API) 1. Create a Google Cloud project at https://console.cloud.google.com 2. Enable the Gmail API 3. Create an OAuth…
GOOGLE_CLIENT_SECRET secret
GOOGLE_REFRESH_TOKEN secret

Alternative Fly.io Anything Dockerized — requires the Fly CLI.

macOS

brew install flyctl && fly launch --from https://github.com/davidnorth/clearmail

Linux

curl -L https://fly.io/install.sh | sh && fly launch --from https://github.com/davidnorth/clearmail

Windows (PowerShell)

iwr https://fly.io/install.ps1 -useb | iex; fly launch --from https://github.com/davidnorth/clearmail

Or deploy to a different host