Skip to content

Self-improving AI Employees for everyone

3.0 KB
Raw Blame
{
  "version": "2026.04",
  "last_updated": "2026-04-02",
  "_source": "https://github.com/pimalaya/himalaya",

  "cli": {
    "binary": "himalaya",
    "homepage": "https://github.com/pimalaya/himalaya",
    "install_url": "https://github.com/pimalaya/himalaya/releases",
    "timeout_seconds": 60
  },

  "defaults": {
    "provider": "gmail",
    "folder": "INBOX",
    "body_type": "text",
    "page_size": 20,
    "flag": "Seen",
    "flag_action": "add"
  },

  "polling": {
    "interval": 60,
    "min_interval": 30,
    "max_interval": 3600,
    "baseline_page_size": 50
  },

  "providers": {
    "gmail": {
      "name": "Gmail",
      "imap_host": "imap.gmail.com",
      "imap_port": 993,
      "imap_encryption": "tls",
      "smtp_host": "smtp.gmail.com",
      "smtp_port": 465,
      "smtp_encryption": "tls",
      "auth_note": "Use App Password from Google Account > Security > 2-Step Verification"
    },
    "outlook": {
      "name": "Outlook / Office 365",
      "imap_host": "outlook.office365.com",
      "imap_port": 993,
      "imap_encryption": "tls",
      "smtp_host": "smtp.office365.com",
      "smtp_port": 587,
      "smtp_encryption": "start-tls",
      "auth_note": "Use account password or App Password"
    },
    "yahoo": {
      "name": "Yahoo Mail",
      "imap_host": "imap.mail.yahoo.com",
      "imap_port": 993,
      "imap_encryption": "tls",
      "smtp_host": "smtp.mail.yahoo.com",
      "smtp_port": 465,
      "smtp_encryption": "tls",
      "auth_note": "Use App Password from Yahoo Account Security"
    },
    "icloud": {
      "name": "iCloud Mail",
      "imap_host": "imap.mail.me.com",
      "imap_port": 993,
      "imap_encryption": "tls",
      "smtp_host": "smtp.mail.me.com",
      "smtp_port": 587,
      "smtp_encryption": "start-tls",
      "auth_note": "Use App-Specific Password from Apple ID"
    },
    "protonmail": {
      "name": "ProtonMail (Bridge)",
      "imap_host": "127.0.0.1",
      "imap_port": 1143,
      "imap_encryption": "none",
      "smtp_host": "127.0.0.1",
      "smtp_port": 1025,
      "smtp_encryption": "none",
      "auth_note": "Requires ProtonMail Bridge running locally"
    },
    "fastmail": {
      "name": "Fastmail",
      "imap_host": "imap.fastmail.com",
      "imap_port": 993,
      "imap_encryption": "tls",
      "smtp_host": "smtp.fastmail.com",
      "smtp_port": 465,
      "smtp_encryption": "tls",
      "auth_note": "Use App Password from Settings > Privacy & Security"
    },
    "custom": {
      "name": "Custom / Self-hosted",
      "_comment": "Every field is blank on purpose. resolve_credentials falls through an `or` chain, so a non-empty preset value here shadows the stored email_* key and makes it unreachable — which is exactly what kept self-hosted servers pinned to 993/465/tls. Defaults live in _himalaya._toml_port / _toml_encryption instead.",
      "imap_host": "",
      "imap_port": "",
      "imap_encryption": "",
      "smtp_host": "",
      "smtp_port": "",
      "smtp_encryption": "",
      "auth_note": "Enter your mail server details"
    }
  }
}