postkitty-Dokumentation

Führen Sie diesen Befehl in einem Terminal aus. Das Plugin kommt aus dem offiziellen Hermes-Plugin-Katalog.

hermes plugins install postkitty

Antworten Sie mit Ja, wenn Hermes nach den Python-Abhängigkeiten und nach dem Aktivieren des Plugins fragt. Diese Variante überspringt beide Fragen:

hermes plugins install postkitty --yes-deps --enable

Öffnen Sie danach einen neuen Chat. Hermes lädt die Tools eines Plugins erst, wenn der nächste Chat beginnt.

Sie können die Installation auch Hermes überlassen. Senden Sie diese Nachricht:

Installiere für mich das Plugin postkitty: Führe im Terminal `hermes plugins install postkitty --yes-deps --enable` aus. Sag mir danach, dass ich einen neuen Chat öffnen soll, damit seine Tools geladen werden.

postkitty braucht keinen API-Schlüssel und kein Konto. Reiner Text kommt ohne die Medienwerkzeuge aus: Auch ohne ffmpeg schreibt und zählt postkitty Ihren Text.

Alles auf einmal prüfen Sie mit diesem Befehl in einem Hermes-Chat:

/postkitty doctor

Der Befehl meldet den Stand von Python, ffmpeg und ffprobe, Untertitel-Unterstützung, OpenCV, Pillow, Gesichtsmodell und Ausgabeordner. Zu jedem Problem nennt er in einer Zeile, wie Sie es beheben, und die letzte Zeile sagt, was jetzt funktioniert: Text, Fotos, Video, Untertitel.

Nennen Sie im neuen Chat die Plattformen und geben Sie Hermes Ihren Entwurf oder den vollständigen Pfad jeder Datei.

Mach mit postkitty aus diesem Beitrag Posts für X, LinkedIn und Instagram und korrigiere meine Formulierungen: [dein Entwurf oder der Pfad zu einem Foto oder Video]

Ein Job besteht aus einem Foto oder einem Video oder je einem von beiden, dazu der Text. Bei mehreren Fotos startet Hermes postkitty einmal pro Foto. Ein Karussell baut postkitty nicht.

Hermes antwortet mit dem Pfad eines Job-Ordners. Die Dateien, die jede Prüfung bestanden haben, liegen in ready/, ein Ordner pro Plattform. Öffnen Sie board.html: Dort steht jede Datei neben ihrem Text, ihrem Alt-Text und ihren Prüfergebnissen.

postkitty/<job>/
  ready/
    instagram/
    linkedin/
    x/
  board.html
  advice.md

Der Job-Ordner entsteht unter ./postkitty in dem Ordner, in dem Ihre Hermes-Sitzung arbeitet. Unter Einstellungen können Sie das ändern.

Liest die Eingaben und plant den Job. Es legt den Job-Ordner an, findet Personen, Einstellungen und Szenen und plant für jedes Ziel den Bildausschnitt. Es rendert nichts und funktioniert auch mit reinem Text.

Rückgabe. Die Job-ID, die Fakten zu jeder Eingabe (Art, Größe, Länge, Personen, Einstellungen), der Plan für jedes Ziel (Layout, Kürzung, Coverbild), die Limits jeder Plattform, die Zählung Ihres Textes und der Pfad eines Vorschaubilds.

Zählt den Text jeder Plattform nach deren echter Regel und schreibt die Textdateien. Text über dem Limit teilt es auf X, Threads oder Bluesky in einen nummerierten Thread. Hermes ruft es mit einem überarbeiteten Entwurf erneut auf, bis jede Plattform ok meldet, und danach für jede spätere Textänderung.

Rückgabe. Für jede Plattform: die Zählung, die Einheit, das Limit, ok, der Überhang und der Teil, der sichtbar bleibt, bevor der Feed den Text abschneidet. Es schreibt advice.md in den Job-Ordner und die Dateien post.txt, thread.txt und alt.txt nach ready/.

Rendert jedes geplante Ziel, prüft jede Datei gegen die veröffentlichten Limits der Plattform, repariert, was durchfällt, und legt nur Dateien in ready/ ab, die alle Prüfungen bestanden haben. Es schreibt auch das Review-Board. Bei einem Job nur mit Text gibt es nichts zu rendern.

Rückgabe. Eine Tabelle mit einer Zeile pro Ziel. Eine Datei ist nur dann bereit zum Hochladen, wenn ihr Status ready oder repaired ist. Zeilen mit failed sagen, was falsch ist, Zeilen mit skipped nennen das fehlende Programm.

Rendert ein Foto- oder Video-Ziel neu, wenn Sie eine Änderung verlangen: ein anderes Layout, eine andere Person im Fokus, eine Kürzung, ein anderes Coverbild oder Untertitel. Es nutzt den vorhandenen Scan und ist deshalb schnell. Schlägt das erneute Rendern fehl, bleibt die frühere Datei, die alle Prüfungen bestanden hat, an ihrem Platz.

Rückgabe. Dieselbe Tabelle wie bei postkitty_make, für dieses eine Ziel.

Prüft eine Datei, die nicht von postkitty stammt, gegen ein Ziel einer Plattform und rendert dabei nichts. Dateien aus make und redo sind bereits geprüft.

Rückgabe. Bestanden oder durchgefallen, dazu jede fehlgeschlagene Prüfung mit dem verletzten Limit.

Geben Sie diese Befehle in einem Hermes-Chat ein. Die Antwort kommt sofort und ohne das Modell.

Dieselbe Engine läuft auch im Terminal, für Skripte und Cron-Jobs:

Drei Einstellungen, alle optional. Sie ändern sie in den Plugin-Einstellungen von Hermes.

Senden Sie JSON mit text. platforms ist optional, Standard sind alle acht. Setzen Sie split_threads auf false, dann erhalten Sie statt eines Threads den Überhang.

curl -s https://postkitty.mertkayacs.com/api/v1/text \
  -H "Content-Type: application/json" \
  -d '{"text": "We shipped postkitty 1.0 today.", "platforms": ["x", "bluesky"]}'

import requests

reply = requests.post(
    "https://postkitty.mertkayacs.com/api/v1/text",
    json={"text": "We shipped postkitty 1.0 today.", "platforms": ["x", "bluesky"]},
    timeout=30,
)
reply.raise_for_status()
for platform, result in reply.json()["platforms"].items():
    print(platform, result["count"], "of", result["limit"], "ok" if result["ok"] else "too long")

const reply = await fetch("https://postkitty.mertkayacs.com/api/v1/text", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ text: "We shipped postkitty 1.0 today.", platforms: ["x", "bluesky"] }),
})
if (!reply.ok) throw new Error((await reply.json()).error.message)
const { platforms } = await reply.json()
for (const [platform, result] of Object.entries(platforms)) {
  console.log(platform, result.count, "of", result.limit, result.ok ? "ok" : "too long")
}

Die Antwort enthält einen Eintrag pro Plattform: count, limit, ok, den Überhang, den Teil, der im Feed sichtbar bleibt, und die Teile des Threads.

Senden Sie die Datei als multipart/form-data mit einem target, zum Beispiel tiktok oder instagram_feed. Die Antwort sagt, ob die Datei besteht, und listet die fehlgeschlagenen Prüfungen auf.

curl -s https://postkitty.mertkayacs.com/api/v1/check \
  -F "[email protected]" \
  -F "target=tiktok"

import requests

with open("clip.mp4", "rb") as clip:
    reply = requests.post(
        "https://postkitty.mertkayacs.com/api/v1/check",
        files={"file": clip},
        data={"target": "tiktok"},
        timeout=120,
    )
reply.raise_for_status()
print(reply.json())

const form = new FormData()
form.append("file", fileInput.files[0])
form.append("target", "tiktok")

const reply = await fetch("https://postkitty.mertkayacs.com/api/v1/check", { method: "POST", body: form })
if (!reply.ok) throw new Error((await reply.json()).error.message)
console.log(await reply.json())

Laden Sie ein Foto oder ein Video als files hoch. GET /v1/limits nennt, wie viele Dateien ein Job annimmt. text, platforms, layout und focus sind optional, und ein Job nur mit Text ist ebenfalls möglich. Der Aufruf kehrt sofort mit der Job-ID und den zugehörigen Links zurück. Fragen Sie den Job alle zwei Sekunden ab, bis sein status done oder failed ist, und laden Sie dann einzelne Dateien oder das ZIP herunter, das auch das Review-Board enthält.

# 1. Start a job. The reply carries its id.
curl -s https://postkitty.mertkayacs.com/api/v1/jobs \
  -F "[email protected]" \
  -F "text=Meet the team behind the launch." \
  -F "platforms=instagram,bluesky"

# 2. Ask every two seconds until status is done or failed.
curl -s https://postkitty.mertkayacs.com/api/v1/jobs/JOB_ID

# 3. Download the finished files as one zip.
curl -s -o postkitty.zip https://postkitty.mertkayacs.com/api/v1/jobs/JOB_ID/download

# 4. Delete the job now instead of waiting.
curl -s -X DELETE https://postkitty.mertkayacs.com/api/v1/jobs/JOB_ID

import time
import requests

API = "https://postkitty.mertkayacs.com/api"

with open("team.jpg", "rb") as photo:
    reply = requests.post(
        f"{API}/v1/jobs",
        files={"files": photo},
        data={"text": "Meet the team behind the launch.", "platforms": "instagram,bluesky"},
        timeout=120,
    )
reply.raise_for_status()
job = reply.json()

while job["status"] in ("queued", "running"):
    time.sleep(2)
    job = requests.get(API + job["links"]["status"], timeout=30).json()

if job["status"] == "done":
    archive = requests.get(API + job["links"]["download"], timeout=120)
    with open("postkitty.zip", "wb") as out:
        out.write(archive.content)
else:
    print(job["error"]["message"], job["error"]["hint"])

requests.delete(API + job["links"]["status"], timeout=30)

const API = "https://postkitty.mertkayacs.com/api"

const form = new FormData()
form.append("files", fileInput.files[0])
form.append("text", "Meet the team behind the launch.")
form.append("platforms", "instagram,bluesky")

let job = await (await fetch(API + "/v1/jobs", { method: "POST", body: form })).json()
if (job.error) throw new Error(job.error.message)

while (job.status === "queued" || job.status === "running") {
  await new Promise((resolve) => setTimeout(resolve, 2000))
  job = await (await fetch(API + job.links.status)).json()
}

if (job.status === "done") {
  for (const file of job.files) console.log(file.path, API + file.url)
  console.log("Everything as one zip:", API + job.links.download)
} else {
  console.error(job.error.message, job.error.hint)
}

Jeder Fehler hat denselben Body. Die Meldung ist ein einfacher Satz, und der Hinweis sagt, was als Nächstes zu tun ist. Beide sind englisch. Wenn Sie übersetzen, unterscheiden Sie die Fehler deshalb anhand von code.

{
  "error": {
    "code": "...",
    "message": "one plain sentence",
    "hint": "what to do"
  }
}

Zwei Codes bitten Sie zu warten: rate_limited (HTTP 429) und queue_full (HTTP 503). Beide senden einen Retry-After-Header mit der Wartezeit in Sekunden.

• Nur Uploads. Die API ruft nie eine URL ab.
• Fotos können JPEG, PNG, WebP oder GIF sein, Videos MP4, MOV, MKV oder WebM. Animierte Bilder werden abgelehnt. GET /v1/limits liefert jede Obergrenze als Zahl: Dateien pro Job, Dateigrößen, Videolänge und Textlänge.
• Aufrufe sind pro Besucher und Stunde begrenzt.
• Ihre Uploads werden gelöscht, sobald der Job fertig ist. Die fertigen Dateien werden 60 Minuten später gelöscht, zu dem Zeitpunkt in expires_at. DELETE entfernt sie sofort.
• Die API postet, veröffentlicht und teilt nichts.

Öffnen Sie einen neuen Chat. Hermes lädt die Tools eines Plugins beim Start eines Chats, deshalb fehlen sie in dem Chat, aus dem Sie installiert haben. Fehlen sie weiterhin, ist das Plugin nicht aktiviert: Führen Sie hermes plugins enable postkitty aus.

ffmpeg oder ffprobe fehlt. Installieren Sie ffmpeg, prüfen Sie, dass ffmpeg und ffprobe in Ihrem Terminal laufen, und fragen Sie dann erneut. Unter macOS fehlt dem ffmpeg, das Hermes mitbringt, ffprobe; brew install ffmpeg ergänzt es. Text und Fotos funktionieren auch ohne die beiden.

postkitty lädt das Gesichtsmodell einmal herunter, bei der ersten Nutzung, und braucht dafür eine Netzwerkverbindung. Gehen Sie online und fragen Sie erneut. Text funktioniert ohne das Modell.

Ihr ffmpeg-Build kann keine Untertitel zeichnen. Installieren Sie einen Build mit libass (mit Homebrew auf macOS ist das ffmpeg-full) oder lassen Sie die Untertitel weg. /postkitty doctor zeigt das in der Zeile „Captions“.

ffmpeg zeichnet Untertitel mit den Schriftarten, die auf dem Rechner installiert sind. Ein Server ohne grafische Oberfläche oder ein Container hat oft keine. Installieren Sie eine (unter Ubuntu zum Beispiel mit sudo apt install fonts-dejavu-core) und fragen Sie erneut. Zählt die Meldung einzelne Zeichen auf, enthält keine installierte Schriftart diese Zeichen: Installieren Sie eine Schriftart für diese Schrift oder entfernen Sie die Zeichen aus der Untertiteldatei. Ein Emoji, das in keiner Schriftart vorkommt, wird weggelassen, und das Ergebnis nennt es. /postkitty doctor zeigt eine fehlende Schriftart in der Zeile „Captions“.

Die Zeile nennt das Limit, das die Datei verletzt hat, und sagt, dass die Reparatur den Verstoß nicht beheben konnte. Verlangen Sie für dieses Ziel ein anderes Layout. pad behält das ganze Bild und passt in den meisten Fällen. Die anderen Ziele behalten ihre Dateien, die bestanden haben.

Sagen Sie über die Position, wen Sie meinen: „die Person links“, „die zweite Person von links“. Siehe Fokus.

Hermes kürzt ihn und zählt erneut. Auf X, Threads und Bluesky können Sie stattdessen einen Thread verlangen.

postkitty erstellt Standbilder und Video. Geben Sie ein Einzelbild als JPEG oder PNG an oder den Clip als Videodatei.

Verlangen Sie einen neuen Durchlauf mit der geänderten Datei. postkitty scannt sie dann erneut und startet einen neuen Job.