About Keryx¶
Why Keryx¶
The blog phpboyscout.uk produces strong writing but relies on organic traffic to find readers. The policy is a reel per post, pushed to the platforms where a new account with no followers can still be shown to people by the feed algorithm. A handful of Python scripts proved that workflow by hand. Keryx turns them into one self-contained, repeatable tool and adds the posting layer.
The name¶
κῆρυξ (kēryx) is Greek for herald: the one who announces and proclaims. That is the tool's job, carrying your words out to an audience. The mark is a stylised kerykeion, the herald's winged staff.
Day to day we use the anglicised pronunciation: "KEH-riks" (or "KEH-ruhks"; /ˈkɛrɪks/, /ˈkɛrəks/), two syllables, stress on the first. That is how English speakers and historians say it, for example when discussing the Kerykes, the Athenian clan of heralds. It is an English adaptation of a Greek word, though, so the living and historical traditions deserve a nod, and all of these are equally acceptable:
- Modern Greek (the living language): "KEE-riks". η and υ have both come to sound ee.
- Biblical / Strong's Greek: "KAY-roox" (kay'-roox). This is the seminary convention for reading the New Testament, where a κῆρυξ is a preacher and publisher of divine truth.
- Classical Attic (5th c. BCE): /kɛ̂ːryks/. Eta is a long "eh" (the vowel in "air") on a falling pitch accent, and upsilon is a fronted vowel like German ü or French u.
However you say it, the herald still rides. 🪽
Status¶
The generation pipeline works end to end: themes, provider seams, and the ported
Python generation (storyboard → VO + music → cards/cover → assembled mp4, or all of it
at once with reel make), plus social copy for each platform. Publishing adapters for
nine platforms are compiled in. The web studio is in active development. What is
deliberately absent, and what looks configurable but is not, is listed on
What Keryx does not do.
Roadmap¶
- Phase 1: themes, provider seams, and a port of the reel generation to Go at parity with the scripts.
- Phase 1.5: the authoring loop. Workspaces, takes and selection, silent drafts, social copy.
- Phase 2: posting adapters, in the order Instagram → YouTube → TikTok → LinkedIn. Facebook, Threads, X, Bluesky and Mastodon have been added since.
- Phase 3: auth, token refresh, scheduled pipelines (
publish due). - Phase 4: the web studio (manage reels, author, preview, publish), shipping in increments.
- Phase 5 (deferred): video panels. No video adapter is registered today, so
resolving
providers.videofails. - Phase 6 (future): longer-form pieces and in-browser capture.
Built on¶
go-tool-base, the framework for
phpboyscout's Go CLI tools. It supplies the command tree, config, keychain, service
lifecycle, the built-in doctor, update and mcp commands, and more. Chat comes
from the go/chat toolkit module. CI uses
the shared phpboyscout/cicd components, and colophon cuts the releases.