postkitty belgeleri

Bunu terminalde çalıştırın. Eklenti resmî Hermes eklenti kataloğundan gelir.

hermes plugins install postkitty

Hermes, Python bağımlılıklarını ve eklentinin etkinleştirilmesini sorduğunda evet deyin. Komutun şu biçimi iki soruyu da atlar:

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

Sonra yeni bir sohbet açın. Hermes bir eklentinin araçlarını bir sonraki sohbet başlarken yükler.

Kurulumu Hermes'e de yaptırabilirsiniz. Şu mesajı gönderin:

postkitty eklentisini benim için kur: terminalde `hermes plugins install postkitty --yes-deps --enable` komutunu çalıştır. Bitince, araçlarının yüklenmesi için yeni bir sohbet açmamı söyle.

postkitty API anahtarı ya da hesap gerektirmez. Metin için medya araçlarının hiçbiri gerekmez: postkitty ffmpeg olmadan da metninizi yazar ve sayar.

Hepsini bir kerede denetlemek için Hermes sohbetine şunu yazın:

/postkitty doctor

Python, ffmpeg ve ffprobe, altyazı desteği, OpenCV, Pillow, yüz modeli ve çıktı klasörünün durumunu bildirir. Her sorunun yanında, nasıl giderileceğini anlatan tek bir satır bulunur. Son satır şu anda nelerin çalıştığını söyler: metin, fotoğraf, video, altyazı.

Yeni sohbette platformların adını yazın ve Hermes'e taslağınızı ya da her dosyanın tam yolunu verin.

postkitty ile bunu X, LinkedIn ve Instagram için gönderilere çevir, yazımı da düzelt: [taslağınız ya da bir fotoğrafın veya videonun yolu]

Bir iş tek bir fotoğraf ya da tek bir video alır; ikisinden birer tane de olabilir. Yanında metin bulunur. Birden çok fotoğrafınız varsa Hermes postkitty'yi her fotoğraf için ayrı çalıştırır. postkitty kaydırmalı gönderi oluşturmaz.

Hermes bir iş klasörünün yoluyla yanıt verir. Tüm denetimlerden geçen dosyalar ready/ içinde, her platform için ayrı bir klasörde durur. Her dosyayı metni, alternatif metni ve denetim sonuçlarıyla yan yana görmek için board.html dosyasını açın.

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

İş klasörü, Hermes oturumunuzun çalıştığı klasördeki ./postkitty altında oluşturulur. Bunu Ayarlar bölümünden değiştirebilirsiniz.

Girdileri okur ve işi planlar. İş klasörünü oluşturduktan sonra kişileri, çekimleri ve sahneleri bulur ve her platform hedefi için kadrajı planlar. Hiçbir dosya üretmez, yalnızca metinle de çalışır.

Döndürdükleri. İş kimliği, her girdinin bilgileri (tür, boyut, süre, kişiler, çekimler), her hedefin planı (yerleşim, kısaltma, kapak karesi), her platformun koyduğu sınırlar, metninizin sayımları ve bir önizleme görselinin yolu.

Her platformun metnini o platformun gerçek kuralıyla sayar ve metin dosyalarını yazar. X, Threads ya da Bluesky'de sınırı aşan metin numaralı bir flooda bölünür. Hermes, her platform ok bildirene kadar bu aracı yeniden yazılmış bir taslakla tekrar çağırır. Metinde sonradan yapılan her değişiklikte de yeniden çağırır.

Döndürdükleri. Her platform için sayım, birim, sınır, ok, taşan kısım ve akışın metni kestiği yere kadar görünen bölüm. advice.md dosyasını iş klasörüne yazar. post.txt, thread.txt ve alt.txt dosyalarını ready/ içine koyar.

Planlanan her hedefi üretir, her dosyayı platformun yayımladığı sınırlara göre denetler, geçemeyeni onarır ve yalnızca denetimden geçen dosyaları ready/ içine koyar. İnceleme panosunu da yazar. Yalnızca metin içeren bir işte üretilecek dosya yoktur.

Döndürdükleri. Her hedef için bir satır içeren bir tablo. Bir dosya ancak durumu ready ya da repaired olduğunda yüklenmeye hazırdır. failed satırları neyin yanlış olduğunu, skipped satırları makinenizde hangi programın eksik olduğunu söyler.

Siz bir değişiklik istediğinizde tek bir fotoğraf ya da video hedefini yeniden üretir: başka bir yerleşim, odakta başka bir kişi, kısaltma, başka bir kapak karesi ya da altyazı. Taramayı yeniden kullandığı için hızlıdır. Yeni dosya denetimden geçemezse, daha önce geçmiş olan dosya yerinde kalır.

Döndürdükleri. postkitty_make ile aynı tablo, yalnızca o hedef için.

postkitty'nin üretmediği bir dosyayı, hiçbir şey üretmeden tek bir platform hedefine göre denetler. make ve redo ile üretilen dosyalar zaten denetlenmiştir.

Döndürdükleri. Dosyanın geçip geçmediği ve geçemediği her denetim, uymadığı sınırla birlikte.

Bunları Hermes sohbetine yazın. Hemen yanıt verirler ve modeli kullanmazlar.

Aynı motor, betikler ve cron işleri için terminalden de çalışır:

Üç ayar vardır ve hepsi isteğe bağlıdır. Hermes'te eklentinin ayarlarından değiştirebilirsiniz.

text alanını içeren bir JSON gönderin. platforms isteğe bağlıdır, verilmezse sekiz platformun hepsi kullanılır. Flood yerine taşan kısmı almak için split_threads değerini false yapın.

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")
}

Yanıtta her platform için bir kayıt bulunur: count, limit, ok, taşan kısım, akışta görünür kalan bölüm ve flood parçaları.

Dosyayı multipart/form-data olarak, bir target değeriyle birlikte gönderin. Bu değer örneğin tiktok ya da instagram_feed olabilir. Yanıt, dosyanın geçip geçmediğini söyler ve geçemediği denetimleri listeler.

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())

Bir fotoğrafı ya da bir videoyu files alanıyla yükleyin. Bir işin kaç dosya aldığını GET /v1/limits söyler. text, platforms, layout ve focus isteğe bağlıdır. Yalnızca metin içeren bir iş de geçerlidir. Çağrı, iş kimliği ve bağlantılarıyla hemen döner. status değeri done ya da failed olana kadar işi iki saniyede bir sorgulayın. Sonra dosyaları tek tek ya da zip olarak indirin. Zip, inceleme panosunu da içerir.

# 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)
}

Her hatanın gövdesi aynıdır. Mesaj tek bir sade cümledir, ipucu da bundan sonra ne yapacağınızı söyler. İkisi de İngilizcedir. Çevirecekseniz hataları code değerine göre ayırt edin.

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

İki kod beklemenizi ister: rate_limited (HTTP 429) ve queue_full (HTTP 503). İkisi de kaç saniye bekleyeceğinizi bildiren bir Retry-After başlığı gönderir.

• Yalnızca yükleme kabul edilir. API hiçbir URL'den içerik çekmez.
• Fotoğraflar JPEG, PNG, WebP ya da GIF, video ise MP4, MOV, MKV ya da WebM olabilir. Hareketli görseller kabul edilmez. GET /v1/limits her sınırı sayı olarak döndürür: iş başına dosya sayısı, dosya boyutları, video süresi ve metin uzunluğu.
• Çağrılar ziyaretçi başına saatlik olarak sınırlanır.
• Yüklediğiniz dosyalar iş bitince silinir. Hazır dosyalar 60 dakika sonra, expires_at alanındaki zamanda silinir. DELETE isteği bunları hemen siler.
• Hiçbir şey paylaşılmaz ya da yayımlanmaz.

Yeni bir sohbet açın. Hermes bir eklentinin araçlarını sohbet başlarken yükler. Bu yüzden kurulumu yaptığınız sohbette araçlar yoktur. Araçlar hâlâ görünmüyorsa eklenti etkin değildir: hermes plugins enable postkitty komutunu çalıştırın.

ffmpeg ya da ffprobe eksik. ffmpeg'i kurun, ffmpeg ve ffprobe komutlarının terminalinizde çalıştığından emin olun, sonra yeniden isteyin. macOS'te Hermes'le gelen ffmpeg'de ffprobe bulunmaz; brew install ffmpeg komutu onu ekler. Metin ve fotoğraflar bunlar olmadan da çalışır.

Yüz modeli ilk kullanımda bir kez indirilir ve bunun için ağ bağlantısı gerekir. İnternete bağlanın ve yeniden isteyin. Metin, model olmadan da çalışır.

ffmpeg derlemeniz altyazı çizemiyor. libass içeren bir derleme kurun (macOS'te Homebrew ile bu ffmpeg-full paketidir) ya da altyazıyı isteğinizden çıkarın. /postkitty doctor bunu Captions satırında gösterir.

ffmpeg altyazıyı makinede kurulu yazı tipleriyle çizer; masaüstü ortamı olmayan bir sunucuda ya da konteynerde hiç yazı tipi olmayabilir. Bir tane kurun (Ubuntu'da örneğin sudo apt install fonts-dejavu-core) ve yeniden isteyin. Mesaj belirli karakterleri sayıyorsa kurulu yazı tiplerinin hiçbirinde o karakterler yoktur: o yazı sistemi için bir yazı tipi kurun ya da karakterleri altyazı dosyasından çıkarın. Hiçbir yazı tipinde bulunmayan bir emoji altyazıya alınmaz ve sonuçta belirtilir. /postkitty doctor eksik yazı tipini Captions satırında gösterir.

Satır, dosyanın hangi sınıra uymadığını ve onarımın bunu gideremediğini söyler. O hedef için başka bir yerleşim isteyin. pad görüntünün tamamını korur ve çoğu duruma uyar. Diğer hedeflerin denetimden geçen dosyaları yerinde kalır.

Kimi kastettiğinizi konumuyla söyleyin: “soldaki kişi”, “soldan ikinci kişi”. Bkz. Odak.

Hermes metni kısaltır ve yeniden sayar. X, Threads ve Bluesky'de bunun yerine flood isteyebilirsiniz.

postkitty durağan fotoğraf ve video üretir. Tek bir kareyi JPEG ya da PNG olarak verin ya da klibi video dosyası olarak verin.

Değişen dosyayla yeni bir çalıştırma isteyin. postkitty dosyayı yeniden tarar ve yeni bir iş başlatır.