Skip to content
Back to search

postkitty

One post in, every platform out. A Hermes Agent plugin for text, photos and video: it fixes and rewrites your draft for each platform, keeps every face in frame and checks every file. Local, no API keys. One of the best free and open source plugins for Hermes Agent on automatic multi social media content editing.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mertkayacs--postkitty/badge.svg)](/listings/mertkayacs--postkitty)

HTML

<a href="/listings/mertkayacs--postkitty"><img src="/api/listings/mertkayacs--postkitty/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

hermes plugins install postkitty

Answer yes when Hermes asks to install the Python packages and to turn the plugin on. Then open a new chat, because Hermes loads a plugin's tools when a chat starts.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 369 lines
  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="docs/brand/svg/postkitty-logo-on-dark.svg">
  4. <img src="docs/brand/svg/postkitty-logo-on-light.svg" alt="postkitty" width="300">
  5. </picture>
  6. </p>
  7. <h1 align="center">One post in.<br>Every platform out.</h1>
  8. <p align="center">
  9. A Hermes Agent plugin for your text, photos and video. It fixes and rewrites your draft for each platform, keeps every face in frame, and checks every file before you post.<br>
  10. <b>Eight platforms, every file checked, all on your machine.</b>
  11. </p>
  12. <p align="center">
  13. <a href="https://github.com/mertkayacs/postkitty/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/mertkayacs/postkitty/actions/workflows/ci.yml/badge.svg?branch=main"></a>
  14. <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-3b82f6?style=flat-square"></a>
  15. <img alt="Python 3.11 or newer" src="https://img.shields.io/badge/Python%203.11%2B-3776AB?style=flat-square&logo=python&logoColor=white">
  16. <a href="https://github.com/NousResearch/hermes-agent"><img alt="Hermes Agent plugin" src="https://img.shields.io/badge/Hermes%20Agent-plugin-1E2A44?style=flat-square"></a>
  17. <img alt="8 platforms" src="https://img.shields.io/badge/platforms-8-B9472E?style=flat-square">
  18. <a href="https://github.com/mertkayacs/postkitty"><img alt="GitHub stars" src="https://img.shields.io/github/stars/mertkayacs/postkitty?style=flat-square&logo=github&color=8A6D3B"></a>
  19. </p>
  20. <p align="center">
  21. <a href="#install"><img alt="Install" src="https://img.shields.io/badge/Install-B9472E?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0Ij48ZyBmaWxsPSJub25lIiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLXdpZHRoPSIyIj48cGF0aCBkPSJNMTIgMjJWMTIiLz48cGF0aCBkPSJtMTYgMTcgMiAyIDQtNCIvPjxwYXRoIGQ9Ik0yMSAxMS4xMjdWOGEyIDIgMCAwIDAtMS0xLjczbC03LTRhMiAyIDAgMCAwLTIgMGwtNyA0QTIgMiAwIDAgMCAzIDh2OGEyIDIgMCAwIDAgMSAxLjcyOWw3IDRhMiAyIDAgMCAwIDIgLjAwMWwxLjMyLS43NTMiLz48cGF0aCBkPSJNMy4yOSA3IDEyIDEybDguNzEtNSIvPjxwYXRoIGQ9Im03LjUgNC4yNyA4Ljk5NyA1LjE0OCIvPjwvZz48L3N2Zz4%3D&logoColor=white"></a>
  22. <a href="https://postkitty.mertkayacs.com/media/explainer.mp4?utm_source=github&utm_medium=readme&utm_campaign=postkitty-repo&utm_content=video-badge"><img alt="Watch the video" src="https://img.shields.io/badge/Watch%20the%20video-B9472E?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0Ij48cGF0aCBmaWxsPSJub25lIiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLXdpZHRoPSIyIiBkPSJNNSA1YTIgMiAwIDAgMSAzLjAwOC0xLjcyOGwxMS45OTcgNi45OThhMiAyIDAgMCAxIC4wMDMgMy40NThsLTEyIDdBMiAyIDAgMCAxIDUgMTl6Ii8%2BPC9zdmc%2B&logoColor=white"></a>
  23. <a href="https://postkitty.mertkayacs.com/try/?utm_source=github&utm_medium=readme&utm_campaign=postkitty-repo&utm_content=try-badge"><img alt="Try it" src="https://img.shields.io/badge/Try%20it-1E2A44?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0Ij48ZyBmaWxsPSJub25lIiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLXdpZHRoPSIyIj48cGF0aCBkPSJNMTQgNC4xIDEyIDYiLz48cGF0aCBkPSJtNS4xIDgtMi45LS44Ii8%2BPHBhdGggZD0ibTYgMTItMS45IDIiLz48cGF0aCBkPSJNNy4yIDIuMiA4IDUuMSIvPjxwYXRoIGQ9Ik05LjAzNyA5LjY5YS40OTguNDk4IDAgMCAxIC42NTMtLjY1M2wxMSA0LjVhLjUuNSAwIDAgMS0uMDc0Ljk0OWwtNC4zNDkgMS4wNDFhMSAxIDAgMCAwLS43NC43MzlsLTEuMDQgNC4zNWEuNS41IDAgMCAxLS45NS4wNzR6Ii8%2BPC9nPjwvc3ZnPg%3D%3D&logoColor=white"></a>
  24. <a href="https://postkitty.mertkayacs.com/docs/?utm_source=github&utm_medium=readme&utm_campaign=postkitty-repo&utm_content=docs-badge"><img alt="Docs" src="https://img.shields.io/badge/Docs-1E2A44?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0Ij48ZyBmaWxsPSJub25lIiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLXdpZHRoPSIyIj48cGF0aCBkPSJNMTIgNXYxNiIvPjxwYXRoIGQ9Ik0yMC4wMDEgMTlBMiAyIDAgMDAyMiAxN1Y1YTIgMiAwIDAwLTEuOTk5LTJMMTYgMy4wMDJBNSA1IDAgMDAxMiA1YTUgNSAwIDAwLTQtMkg0YTIgMiAwIDAwLTIgMnYxMmEyIDIgMCAwMDEuOTk5IDJIOGE1IDUgMCAwMTQgMiA1IDUgMCAwMTQtMnoiLz48L2c%2BPC9zdmc%2B&logoColor=white"></a>
  25. <a href="https://postkitty.mertkayacs.com/?utm_source=github&utm_medium=readme&utm_campaign=postkitty-repo&utm_content=website-badge"><img alt="Website" src="https://img.shields.io/badge/Website-1E2A44?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0Ij48ZyBmaWxsPSJub25lIiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLXdpZHRoPSIyIj48Y2lyY2xlIGN4PSIxMiIgY3k9IjEyIiByPSIxMCIvPjxwYXRoIGQ9Ik0xMiAyYTE0LjUgMTQuNSAwIDAgMCAwIDIwYTE0LjUgMTQuNSAwIDAgMCAwLTIwTTIgMTJoMjAiLz48L2c%2BPC9zdmc%2B&logoColor=white"></a>
  26. <a href="https://github.com/NousResearch/hermes-agent"><img alt="Hermes Agent" src="https://img.shields.io/badge/Hermes%20Agent-1E2A44?style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0Ij48ZyBmaWxsPSJub25lIiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLXdpZHRoPSIyIj48cGF0aCBkPSJNMTIgOFY0SDgiLz48cmVjdCB3aWR0aD0iMTYiIGhlaWdodD0iMTIiIHg9IjQiIHk9IjgiIHJ4PSIyIi8%2BPHBhdGggZD0iTTIgMTRoMiIvPjxwYXRoIGQ9Ik0yMCAxNGgyIi8%2BPHBhdGggZD0iTTE1IDEzdjIiLz48cGF0aCBkPSJNOSAxM3YyIi8%2BPC9nPjwvc3ZnPg%3D%3D&logoColor=white"></a>
  27. </p>
  28. postkitty by Mert Kaya is a plugin for [Hermes Agent](https://github.com/NousResearch/hermes-agent) that turns one post (a draft, a photo, a landscape video, or only text) into a folder of upload-ready files for Instagram, TikTok, YouTube Shorts, X, LinkedIn, Threads, Bluesky and Facebook, each one checked against that platform's published limits and repaired when it fails.
  29. One of the best free and open source plugins for Hermes Agent on automatic multi social media content editing.
  30. [![Watch the postkitty video: one film scene with a box around each face, and the Instagram Reel, TikTok and X files made from it](docs/explainer-poster.jpg)](https://postkitty.mertkayacs.com/media/explainer.mp4?utm_source=github&utm_medium=readme&utm_campaign=postkitty-repo&utm_content=video-poster)
  31. ---
  32. ## What the plugin does on your machine
  33. - <img src="docs/assets/readme/icons/scan-face.svg" width="18" height="18" alt=""> **Finds the faces in a photo and tracks them through a video.** Crops and vertical clips are built around those people, so they stay in frame.
  34. - <img src="docs/assets/readme/icons/video.svg" width="18" height="18" alt=""> **Renders with ffmpeg.** You get upload files at each platform's size, trimmed to its length, and every video comes with a cover frame.
  35. - <img src="docs/assets/readme/icons/type.svg" width="18" height="18" alt=""> **Counts text the way each platform does.** X is counted by the rules of its own twitter-text library, where a link is 23 characters and an emoji 2. Threads counts every emoji as its UTF-8 bytes, Bluesky counts graphemes and TikTok counts UTF-16 units.
  36. - <img src="docs/assets/readme/icons/list-checks.svg" width="18" height="18" alt=""> **Checks every file against the platform's published limits and repairs what fails.** Only passing files reach `ready/`.
  37. - <img src="docs/assets/readme/icons/layout-grid.svg" width="18" height="18" alt=""> **Builds a review board,** one page that shows every file with its text, alt text and checks.
  38. - <img src="docs/assets/readme/icons/square-terminal.svg" width="18" height="18" alt=""> **Works without the model too.** `/postkitty` shows every size and limit, checks your setup and checks a file. `hermes postkitty` does the same from a terminal and makes the files, for scripts and cron jobs.
  39. The words come from the model your Hermes uses: the rewritten drafts, the advice on where to post, and the alt text. The rest is code in this repository.
  40. ![A landscape podcast frame with a box around each of the two hosts, and the vertical clip made from it: one host in the top half, the other in the bottom half.](docs/assets/readme/split-screen.jpg)
  41. ## Install
  42. ```sh
  43. hermes plugins install postkitty
  44. ```
  45. Answer yes when Hermes asks to install the Python packages and to turn the plugin on. Then open a new chat, because Hermes loads a plugin's tools when a chat starts.
  46. ## What you need
  47. - **Hermes Agent 0.22.7 or newer**, running on Python 3.11 or newer.
  48. - **Five Python packages:** OpenCV, NumPy, Pillow, regex and ruamel.yaml. Hermes installs them during the install step.
  49. - **ffmpeg with ffprobe, for video only.** Text and photos work without it. A Hermes set up with the official installer brings its own ffmpeg: on Windows and most Linux systems there is nothing to install, and on macOS that copy comes without ffprobe, so run `brew install ffmpeg` once. Burning in captions needs an ffmpeg build with libass and one font on the machine, which a bare server or a container may not have.
  50. To check all of it, type this in a Hermes chat. It prints one fix line for each thing that is missing.
  51. ```text
  52. /postkitty doctor
  53. ```
  54. ## Say this to your Hermes
  55. Hermes can do the install for you. Send these two messages, the second one in a new chat.
  56. ```text
  57. Install the postkitty plugin for me: run `hermes plugins install postkitty --yes-deps --enable` in the terminal. When it finishes, tell me to open a new chat so its tools load.
  58. ```
  59. ```text
  60. Use postkitty to turn this into posts for X, LinkedIn and Instagram and fix my wording: [your draft, or the path to a photo or video]
  61. ```
  62. ## What it can do
  63. Each line starts with a request you can paste, followed by what comes back.
  64. - **Text.** "Fix my wording and write this for X, LinkedIn and Threads: [your draft]"
  65. Your draft comes back with the spelling and grammar fixed, in one version per platform, each counted to fit. A long post can become a thread.
  66. - **Photos.** "Make team.jpg ready for Instagram and Bluesky, and keep everyone in the picture."
  67. One image per feed, framed around the people in it, with location and camera metadata removed.
  68. - **Video.** "Turn talk.mp4 into vertical clips for TikTok, Reels and Shorts."
  69. Vertical clips that follow the person on screen. Two people get a split screen, a cut to whoever is talking, or the whole wide shot.
  70. - **Captions.** "Burn the subtitles from talk.srt into the TikTok clip."
  71. The lines of your `.srt` or `.vtt` file are drawn into the video, clear of the platform's buttons.
  72. - **Checks.** "Will this file upload to TikTok? [path to the file]"
  73. A pass or a fail against TikTok's limits, with every failing check named. This works for files postkitty did not make.
  74. postkitty never posts, uploads or schedules anything. You upload the files in `ready/` yourself.
  75. ![The postkitty review board for one podcast post: the Instagram Reel, feed photo, Story and TikTok files, each marked Ready with its size, layout note, alt text and passed checks.](docs/assets/readme/hero.jpg)
  76. *The review board of one real run on a demo podcast clip and team photo. The people in the demo footage and photos are AI-generated.*
  77. ## How to ask
  78. - Name the platforms: "for Instagram and TikTok" tells postkitty which files to make.
  79. - Give the path of the photo or the video and paste your draft. One job takes one photo, one video, or one of each.
  80. - Tell it who has to stay in frame, for example "keep everyone in the picture" or "focus on the person on the left".
  81. - With two people on camera, name the layout: a split screen, a cut to whoever is talking, or the whole wide shot.
  82. - A trim and a cover frame need times: "use 0:12 to 0:48 and take the cover at 0:20".
  83. - Ask for a change in plain words afterwards: "shorter for X" or "more formal on LinkedIn". Hermes redoes only that part.
  84. [docs/how-to-ask.md](docs/how-to-ask.md) is the full guide, with a vague request next to a clear one for each case.
  85. ## Platforms
  86. - **Instagram.** Reel and Story 1080×1920, feed photo 1080×1350. Text up to 2,200 characters and 5 hashtags.
  87. - **TikTok.** Video 1080×1920. Text up to 2,200 UTF-16 units.
  88. - **YouTube Shorts.** Short 1080×1920. Title up to 100 characters.
  89. - **X.** Video 1920×1080, image 1600×900. Text up to 280 weighted characters, where a link counts 23.
  90. - **LinkedIn.** Video 1080×1350, image 1080×1080. Text up to 3,000 characters.
  91. - **Threads.** Video 1080×1920, image 1080×1350. Text up to 500 characters, with every emoji counted as its UTF-8 bytes.
  92. - **Bluesky.** Video 1080×1920, image 1080×1350. Text up to 300 graphemes.
  93. - **Facebook.** Reel 1080×1920, feed photo 1080×1350. Text up to 63,206 characters.
  94. [docs/platforms.md](docs/platforms.md) lists every limit with the page it came from and the date it was checked. The data lives in [data/platforms.yaml](data/platforms.yaml).
  95. ## Try it in the browser
  96. Paste a draft or drop a photo or a video at [postkitty.mertkayacs.com/try](https://postkitty.mertkayacs.com/try/?utm_source=github&utm_medium=readme&utm_campaign=postkitty-repo&utm_content=try-link) and get the result for each platform, with nothing to install.
  97. The same engine answers over HTTP at `https://postkitty.mertkayacs.com/api`. [docs/api.md](docs/api.md) has the endpoints, and the [docs site](https://postkitty.mertkayacs.com/docs/?utm_source=github&utm_medium=readme&utm_campaign=postkitty-repo&utm_content=docs-link) carries every guide in English, Turkish and German.
  98. ## Documentation
  99. - [How to ask](docs/how-to-ask.md): requests that get the right result the first time
  100. - [Tools](docs/tools.md): the five tools, the `/postkitty` and `hermes postkitty` commands and the settings
  101. - [Layouts](docs/layouts.md): crop, split, speaker, seam, pad and focus, with examples
  102. - [Platforms](docs/platforms.md): every size and limit with its source
  103. - [HTTP API](docs/api.md): the hosted API behind the playground
  104. - [Architecture](docs/architecture.md): how the code is organised and how a job runs
  105. - [Troubleshooting](docs/troubleshooting.md): what each failure message means and what to do
  106. ## Good to know
  107. <details>
  108. <summary><b>What it touches on your machine</b></summary>
  109. postkitty touches these things on your machine:
  110. - **Network:** one download. The first time a photo or a video is scanned, postkitty fetches the YuNet face detector from the OpenCV Zoo repository on GitHub, pinned to one commit, and checks its size and SHA-256 before using it. It makes no other request and sends no telemetry.
  111. - **Files it reads:** the photos, videos and subtitle files you name. It leaves them unchanged.
  112. - **Files it writes:** the job folder (`./postkitty` in the session's working folder unless you set another one) and its own data folder in the Hermes home, `plugin-data/postkitty/`, which holds the face model and cached detections. Nothing is written into the plugin's install folder.
  113. - **Commands it runs:** `ffmpeg` and `ffprobe`, only while a tool call is working. The seam layout uses `caire` when it is installed.
  114. - **Background processes:** none.
  115. - **Credentials:** none. It needs no API key and stores no account data.
  116. - **The model:** your draft goes to the model your Hermes is set up with, as in any Hermes chat. That model writes the text, the advice and the alt text.
  117. [SECURITY.md](SECURITY.md) says how to report a security problem.
  118. </details>
  119. <details>
  120. <summary><b>Where are my files?</b></summary>
  121. Each job gets its own folder. The files to upload are under `ready/`, one folder per platform.
  122. ```text
  123. postkitty/20261111-0930-talk/
  124. ready/
  125. instagram/ reel.mp4 reel_cover.jpg feed.jpg post.txt alt.txt
  126. tiktok/ tiktok.mp4 tiktok_cover.jpg post.txt
  127. x/ video.mp4 video_cover.jpg thread.txt
  128. board.html the review board
  129. advice.md the platforms ranked for this post, with tips
  130. contact.png every file on one image
  131. manifest.json what was made, with every check
  132. work/ caches and intermediate renders
  133. ```
  134. </details>
  135. <details>
  136. <summary><b>Which tools does Hermes call?</b></summary>
  137. Hermes calls five tools, in this order. [docs/tools.md](docs/tools.md) has their arguments and results.
  138. 1. `postkitty_scan` reads your photo or video and your draft, and plans a framing for each platform. It renders nothing.
  139. 2. `postkitty_write` counts each platform's text with its real rule and writes the text files.
  140. 3. `postkitty_make` renders every file, checks it, repairs failures and builds the review board.
  141. 4. `postkitty_redo` makes one photo or video output again with another layout, focus, trim, cover frame or captions.
  142. 5. `postkitty_check` checks a file postkitty did not make against one platform.
  143. </details>
  144. <details>
  145. <summary><b>Which commands work without the model?</b></summary>
  146. postkitty has commands that answer from the plugin, with no model involved.
  147. In a Hermes chat:
  148. - `/postkitty` shows what it does, example requests and every target with its size and limits.
  149. - `/postkitty tiktok` shows one platform.
  150. - `/postkitty doctor` checks your setup and prints one fix line for each problem.
  151. - `/postkitty check clip.mp4 tiktok` checks a file against a target.
  152. In a terminal, for scripts, cron jobs and release automation:
  153. ```sh
  154. hermes postkitty make clip.mp4 --text-file post.txt --platforms tiktok,x
  155. hermes postkitty check clip.mp4 --target tiktok
  156. hermes postkitty platforms
  157. hermes postkitty doctor
  158. ```
  159. `hermes postkitty make` uses your text as written: it counts and splits it for each platform and does not rewrite it. It exits with 0 only when every file is ready. [docs/tools.md](docs/tools.md#the-hermes-postkitty-terminal-command) has the options and the exit codes.
  160. </details>
  161. <details>
  162. <summary><b>Which settings can I change?</b></summary>
  163. postkitty has three settings. Change them on the plugin's settings page in Hermes, or under `plugins.entries.postkitty.settings` in `config.yaml`.
  164. - **`output_dir`**, empty by default: where job folders go. Empty means `./postkitty` in the session's working folder.
  165. - **`default_platforms`**, empty by default: the platforms to make when you name none. Empty means every platform that fits the input.
  166. - **`loudness_lufs`**, -14 by default: the loudness target for video audio, from -70 to -5.
  167. </details>
  168. <details>
  169. <summary><b>A real run: one draft, rewritten for X, Bluesky and LinkedIn</b></summary>
  170. This is one real run: a rough draft, and what came back for X, Bluesky and LinkedIn.
  171. **The draft**
  172. > new episode of two builders is out!! maya and sam talks about how we shiped our app in one weekend, what we cut what broke at 2am and why the launch posts took longer then the code lol. its honestly the most usefull episode we did so far for anyone building on there own
  173. **X** · 245 of 280 weighted characters
  174. > New episode of Two Builders is out. Maya and Sam talk about how we shipped our app in one weekend: what we cut, what broke at 2am, and why the launch posts took longer than the code. Our most useful episode so far if you're building on your own.
  175. **Bluesky** · 221 of 300 graphemes
  176. > New Two Builders episode is out. Maya and Sam on shipping our app in one weekend: what we cut, what broke at 2am, and why the launch posts took longer than the code. Our most useful one yet if you're building on your own.
  177. **LinkedIn** · 319 of 3,000 characters
  178. > New episode of Two Builders is out.
  179. >
  180. > Maya and Sam talk about how we shipped our app in one weekend: what we cut, what broke at 2am, and why the launch posts took longer than the code.
  181. >
  182. > It's honestly the most useful episode we've done so far, especially if you're building on your own.
  183. >
  184. > #BuildInPublic #Startups #Podcast
  185. The next message in the same chat asked for a change:
  186. > Make the LinkedIn post more formal, and turn the X post into a thread of two posts.
  187. **X thread, post 1** · 98 of 280 weighted characters
  188. > New episode of Two Builders is out. Maya and Sam talk about how we shipped our app in one weekend.
  189. **X thread, post 2** · 146 of 280 weighted characters
  190. > What we cut, what broke at 2am, and why the launch posts took longer than the code. Our most useful episode so far if you're building on your own.
  191. **LinkedIn, more formal** · 337 of 3,000 characters
  192. > We have released a new episode of Two Builders.
  193. >
  194. > Maya and Sam discuss how we shipped our app in one weekend: what we cut, what broke at 2am, and why the launch posts took longer to produce than the code.
  195. >
  196. > It is the most useful episode we have made so far, particularly for anyone building on their own.
  197. >
  198. > #BuildInPublic #Startups #Podcast
  199. <details>
  200. <summary><b>It works in your language: the same post in Turkish and German</b></summary>
  201. The same post works in other languages. Here it is in Turkish and in German.
  202. **Turkish draft**
  203. > two builders'ın yeni bölümü çıktı!! maya ve sam uygulamamızı bir hafta sonunda nasıl yayınladığımızı anlatıyo, neleri kestik gece 2de ne bozuldu ve lansman paylaşımları neden koddan uzun sürdü. kendi başına bir şey geliştiren herkez için şimdiye kadarki en faydalı bölüm bence
  204. **X** · 270 of 280 weighted characters
  205. > Two Builders'ın yeni bölümü çıktı! Maya ve Sam, uygulamamızı bir hafta sonunda nasıl yayınladığımızı anlatıyor: neleri kestik, gece 2'de ne bozuldu, lansman paylaşımları neden koddan uzun sürdü. Kendi başına geliştiren herkes için şimdiye kadarki en faydalı bölüm bence.
  206. **German draft**
  207. > neue folge von two builders ist drausen!! maya und sam erzählen wie wir unsere app an einem wochenende gelauncht haben, was wir gestrichen haben was um 2 uhr nachts kaputt ging und warum die launch posts länger gedauert haben als der code. ehrlich die nützlichste folge bis jetzt für alle die alleine was bauen
  208. **X** · 235 of 280 weighted characters
  209. > Neue Folge von Two Builders ist da. Maya und Sam erzählen, wie wir unsere App an einem Wochenende gelauncht haben: was wir gestrichen haben, was um 2 Uhr nachts kaputt ging und warum die Launch-Posts länger gedauert haben als der Code.
  210. </details>
  211. *The text in these runs comes from the model Hermes used, Claude Sonnet 5.5. postkitty counted and checked every version.*
  212. </details>
  213. <details>
  214. <summary><b>How do I update or remove it?</b></summary>
  215. To update or remove postkitty, use the Hermes plugin commands:
  216. ```sh
  217. hermes plugins update postkitty
  218. hermes plugins remove postkitty
  219. ```
  220. Your job folders stay where they are when you remove the plugin.
  221. </details>
  222. <details>
  223. <summary><b>What is postkitty built on?</b></summary>
  224. postkitty is built on [OpenCV](https://opencv.org) and the [YuNet](https://github.com/opencv/opencv_zoo/tree/main/models/face_detection_yunet) face detector, [FFmpeg](https://ffmpeg.org), [Pillow](https://python-pillow.org) and [NumPy](https://numpy.org), with the counting rules of [twitter-text](https://github.com/twitter/twitter-text) and the [AT Protocol lexicons](https://github.com/bluesky-social/atproto). Seam carving can use [caire](https://github.com/esimov/caire) by Endre Simo.
  225. [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) lists the material this repository takes from other projects, with the licence of each.
  226. </details>
  227. ## Development
  228. ```sh
  229. python -m pytest -q
  230. ruff check .
  231. ```
  232. The tests use synthetic clips and a stand-in face detector, so they download nothing. GitHub Actions runs them on Linux, macOS and Windows, and installs the plugin into a brand-new Hermes on every change.
  233. - `plugin.yaml`, `__init__.py`: the manifest and `register(ctx)`
  234. - `schemas.py`, `tools.py`: what Hermes sees, and the handlers behind it
  235. - `command.py`: the `/postkitty` command
  236. - `engine/`: the library, with `pipeline`, `photo`, `video`, `text`, `verify` and `board`
  237. - `data/platforms.yaml`: every size and limit, with its source
  238. - `skills/postkitty/SKILL.md`: the workflow Hermes follows
  239. [docs/architecture.md](docs/architecture.md) explains the layers and the life of a job. [CONTRIBUTING.md](CONTRIBUTING.md) covers setup, style and how to add a platform, and [CHANGELOG.md](CHANGELOG.md) lists what changed in each release.
  240. If postkitty is useful to you, a star helps other people find it.
  241. ## License
  242. [MIT](LICENSE). postkitty is built by [Mert Kaya](https://mertkayacs.com/?utm_source=github&utm_medium=readme&utm_campaign=postkitty-repo&utm_content=license-author) ([@mertkayaai](https://x.com/mertkayaai) on X, [@mertkayacs](https://github.com/mertkayacs) on GitHub) at Eschatia Labs, an independent, non-profit open-source AI research lab. Photos behind the screenshots are credited in [docs/assets/readme/CREDITS.md](docs/assets/readme/CREDITS.md).
  243. Material from other projects is listed with its licences in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
  244. [![views](https://hits.sh/github.com/mertkayacs/postkitty.svg?view=today-total&style=flat-square&label=views&color=B9472E&labelColor=1E2A44)](https://postkitty.mertkayacs.com/?utm_source=github&utm_medium=readme&utm_campaign=postkitty-repo&utm_content=views-badge)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.