Skip to content

jayascript/button2beehiiv

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Button2Beehiiv

Button2Beehiiv

An automated content pipeline that transforms a single button press into a newsletter ready for syndication 🚀

The system uses multiple AI agents, each specialized for a different task, orchestrated by a human Operator to produce high-quality, personality-driven newsletters.

Currently In Development:

  • Homelab Highlights: a weekly roundup for the self-hosting and homelab community
  • The Nomad Nurses Dispatch: a weekly newsletter for travel nurses

Workflow

v1: Newsletter Generation

StepAgentInputOutput
Identify target audienceMarket ResearchPublicationAudience Snapshot
Identify trending storiesResearch AnalystPublication + Audience SnapshotTop Stories
Generate newsletterWriting AssistantPublication + Snapshot + Stories + PersonaDraft Newsletter
Finalize newsletterEditorial Assistantsame as above + Draft NewsletterFinal Newsletter
Publish newsletterAdmin AssistantFinal Newsletter + HTML TemplatePublished 2 Beehiiv

v2: YouTube Script Generation

StepAgentInputOutput
Publish newsletterPublished 2 Beehiiv
Identify influential videosCompetitor AnalystPublished 2 Beehiiv + Audience SnapshotCompetitor Analysis
Suggest 5 fresh takesMarketing AnalystAudience Snapshot + Competitor AnalysisProduction Brief
Generate scriptWriting AssistantCompetitor Analysis + Production BriefVideo Script
Finalize scriptMarketing AssistantVideo Script + Competitor AnalysisYouTube Script
Generate videoProduction AssistantYouTube Script + Competitor AnalysisYouTube Video
Publish videoAdmin AssistantYouTube Script + YouTube VideoPublished 2 YouTube

Project Status

PROG 🟡 Phase 1: Architecture & Prompt Engineering

  • State “PROG” from “PROJ” [2026-01-18 Sun 17:49]

Define publication configuration schema

  • State “DONE” from “TODO” [2026-01-18 Sun 17:49]

Define persona/voice schema

  • State “DONE” from “TODO” [2026-01-18 Sun 17:49]

NEXT Define necessary integrations

Craft system messages for prompt chain

Run prompt chain end-to-end

Test and refine prompt chain

PROJ Phase 2: UI/UX Design & Syndication

Create Beehiiv publications

Import generated newsletter into Beehiiv

Test and refine UI

Send test emails

Test and refine UX

Tech Stack

LangFlow

Visual workflow builder

Composio

Simplified API integration

Beehiiv

Quick & easy newsletter platform

Emacs/Org-mode

Documentation and prompt chain management

Local Development

Requirements

  • OpenRouter API Key
  • LangFlow

Philosophy

Wisdom Before Workflows

  • Every component should be documented.
  • Workflow must be able to be run manually without automation.

Personality Over Polish

  • Content should be thoughtful, engaging, and human-coded.
  • Devs are encouraged to add some personality to the newsletters, within reason.

Iterate and Improve

  • Ship something. Quick, while no one’s watching!
  • Fix it later. (Probably no one will even notice.)

License

Source code in this repository is made available under the MIT License.