Alex: automation for Hermes Agent

Foreign-trade sales agent built on Hermes Agent with browser research, Gmail and WhatsApp follow-up

What Alex does

Alex runs on top of Hermes Agent and adds an independent export-sales identity, domain skills, 28 domain tools and a separate profile under ~/.alex/profiles/alex that does not copy credentials or sessions from an existing Hermes install. It first interviews you about your product, target market and buyer types, and it keeps the facts you give it, such as certifications, lead times and channel preferences, for later sessions. Research tasks drive a real Chromium browser and save companies, public contact details, source text and checkpoints, so interrupted work can resume.

With Gmail connected, Alex can search and read mail, reply in the original thread and prepare outreach. Gmail, WhatsApp and WhatsApp Cloud sends go through a local recipient policy and a communication ledger that records attempts, provider message IDs, daily quotas and unsubscribes to avoid duplicate sends, and the agent may send only to recipients you explicitly authorize. A 19-tool MCP research service and an optional admin page for customers, evidence and tasks are included. The README states that real-model, mailbox and public outreach acceptance is still pending and the production customer count is 0.

Key features

Hermes profile distribution with 28 domain tools
Long-term business memory for product facts and customer progress
Real Chromium research with saved sources and task checkpoints
Gmail search, read, reply and follow-up, plus WhatsApp sending
Communication ledger with idempotency, daily quotas and unsubscribe handling
Optional admin page with browser takeover

When to use it

Researching importers and distributors for an export product with a source for every judgment
Drafting and following up customer emails with recipient-level authorization
Resuming an interrupted buyer-research task from its checkpoint

Who it is for: Exporters, B2B sales teams and founders who want a Hermes-based agent for foreign-trade customer development.

How it fits with Hermes Agent

Built on the Hermes Agent execution core as a Hermes profile distribution, reusing Hermes sessions, memory, skills, gateway and native scheduled jobs.

How to install Alex

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

npm ci
npm run alex -- init
npm run alex -- model
npm run alex -- start

Requirements: An installed Hermes Agent, Node.js 24.5 or newer and Chromium; the business service uses flock on Linux or WSL2, and Windows needs native Hermes plus a WSL2 service

Note: The README states that real-model, mailbox, WhatsApp and public outreach acceptance is still pending and the production customer count is 0.

FAQ

What is Alex?

Alex is a foreign-trade expert agent that learns your product, researches real buyers in a browser and keeps follow-up progress in long-term memory. It connects to Gmail and WhatsApp for customer communication.

Does Alex work with Hermes Agent?

Yes, it is built on the Hermes Agent execution core and ships as a Hermes profile distribution with its own profile under ~/.alex/profiles/alex. It reuses Hermes sessions, memory, skills, the gateway and native scheduled jobs.

What do I need to run Alex?

You need an installed Hermes Agent, Node.js 24.5 or newer and Chromium. The business service uses flock on Linux or WSL2, so Windows users run native Hermes with a WSL2 service.