wtf is hermes-flywheel?

Hermes Flywheel is a customer acquisition planning tool for early-stage founders. You describe your product, the type of customer you are trying to reach, your competitors, and your budget, and the tool produces a weekly go-to-market sprint: a structured plan covering channel launches, competitor analysis, warm outbound campaigns, creator partnerships, trend-based content, and a set of spend cards that require your approval before any money moves. The tool runs in two modes. The first is a standalone Python CLI that needs no API keys or external services to try: a single command runs a full demo sprint using included sample data and writes a report you can read. For a real run, you can optionally add a Serper API key for live backlink and trend research, a leads CSV for warm outbound targeting, or a Stripe test key for real test-mode payment authorization cards. Nothing is sent, posted, or paid automatically: every action requires an explicit approval step. The second mode runs as a conversational agent through a separate runtime called Hermes (from Nous Research). With Hermes connected, you interact with Flywheel through a chat interface in the terminal, Slack, or Telegram. You can ask it to start your flywheel, get updates, and approve or reject proposed actions in a conversation. The underlying pipeline is the same in both modes. The repo is organized around a skill file and a set of deterministic Python scripts that handle intake, research, scoring, formatting, approval gating, and a run ledger. A sample fixture set ships with the repo so the demo works with zero configuration. This is for solo founders and small teams who want a structured, repeatable process for customer acquisition that they can run weekly and review before committing to any spend.