explaingit

ksimback/hermes-flywheel

Analysis updated 2026-05-18

★ 6PythonAudience · pm founderComplexity · 3/5Setup · easy

TLDR

A customer acquisition agent for early-stage founders that turns a product description and budget into a weekly go-to-market sprint with channel plans, outbound lists, and approval-gated spend cards.

Mindmap

mindmap
  root((hermes-flywheel))
    Two Run Modes
      Standalone CLI
      Hermes chat agent
    Sprint Sections
      Channel launch plan
      Competitor backlinks
      Warm outbound list
      MPP spend cards
    Approval Gates
      Nothing sent automatically
      Review then approve
      Run ledger tracking
    Optional Inputs
      Serper for live research
      Leads CSV for outbound
      Stripe test key
    Chat Channels
      Terminal
      Slack
      Telegram
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a zero-config demo sprint with no API keys to see a sample weekly acquisition plan before wiring up real data.

USE CASE 2

Generate a weekly customer acquisition sprint for your product by providing an ICP, competitor list, budget, and optional leads CSV.

USE CASE 3

Install Flywheel as a Hermes chat profile so a Slack or Telegram bot can present the sprint and collect your approvals conversationally.

USE CASE 4

Use the approval gates to review proposed outbound messages, ad spend, and channel launches before anything is sent or paid.

What is it built with?

PythonHermes agent runtimeSlackTelegramSerper

How does it compare?

ksimback/hermes-flywheelashishdevasia/ha-proton-drive-backupbro77xp/beginner-friendly-ai-vtuber
Stars666
LanguagePythonPythonPython
Setup difficultyeasymoderatehard
Complexity3/52/53/5
Audiencepm founderops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Demo needs only Python 3.8+ and git, real runs benefit from a Serper API key for live research and a leads CSV for outbound.

No license information is stated in the repository.

In plain English

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.

Copy-paste prompts

Prompt 1
Walk me through running the Hermes Flywheel demo sprint: what command do I run, what does the output look like, and where is the report written?
Prompt 2
Run a real Flywheel sprint for my company: product is [describe], ICP is [who I sell to], competitors are rival.com, budget is $500. Walk me through the flywheel.py run command and what sections the sprint will include.
Prompt 3
Install Hermes Flywheel as a Hermes chat profile in Telegram so I can interact with my GTM plan conversationally. Walk me through the hermes profile install and setup commands.
Prompt 4
My Flywheel sprint has pending spend cards waiting for approval. Walk me through using approvals.py status, finalize, and approve to review and green-light only the outbound section.
Prompt 5
Explain what each section of the Flywheel weekly sprint covers: channel launch plan, backlinks, warm outbound list, creator campaigns, MPP spend cards, and trend content.

Frequently asked questions

What is hermes-flywheel?

A customer acquisition agent for early-stage founders that turns a product description and budget into a weekly go-to-market sprint with channel plans, outbound lists, and approval-gated spend cards.

What language is hermes-flywheel written in?

Mainly Python. The stack also includes Python, Hermes agent runtime, Slack.

What license does hermes-flywheel use?

No license information is stated in the repository.

How hard is hermes-flywheel to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is hermes-flywheel for?

Mainly pm founder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub ksimback on gitmyhub

Verify against the repo before relying on details.

Alternatives & similar repos