AgentGIF Hakkında
Çift katmanlı mimariye sahip geliştirici GIF barındırma: GIF insanlar için, Cast ajanlar için.
AgentGIF Nedir?
AgentGIF, terminal demo GIF'leri için özel olarak tasarlanmış bir barındırma platformudur. AgentGIF'e yüklenen her GIF iki katmana sahiptir:
- Görsel katman — GitHub README dosyalarında, dokümantasyon sitelerinde ve blog yazılarında satır içi oynatılan animasyonlu bir GIF görüntüsü. JavaScript oynatıcısına gerek yoktur.
- Makine katmanı — Yapay zeka ajanlarının komutları okuyabilmesi, çıktıyı anlayabilmesi ve belirli adımlara başvurabilmesi için düz metin dökümüyle eşleştirilmiş bir asciinema v2 cast dosyası.
Bu çift katmanlı yaklaşım, tek bir URL'nin her iki kitleye de hizmet etmesi anlamına gelir: bir insan animasyonlu terminal demosu görürken, bir yapay zeka ajanı ayrıştırıp üzerinde akıl yürütebileceği yapılandırılmış veriler alır.
Neden AgentGIF?
Terminal demo GIF'leri açık kaynak dokümantasyonun her yerindedir. Ancak iki temel sorunları vardır:
- GIF görüntüleri yapay zekaya opaktır — bir yapay zeka ajanı README'de bir GIF ile karşılaştığında ikili piksel verisi görür. Komutları çıkaramaz, çıktıyı okuyamaz veya adımları açıklayamaz. AgentGIF, her GIF'e makine tarafından okunabilir cast dosyaları ve dökümleri ekleyerek bunu çözer.
- Özel barındırma yok — geliştiriciler terminal GIF'lerini meta verileri silen, agresif şekilde sıkıştıran ve arama ya da düzenleme imkânı sunmayan genel görüntü barındırma hizmetlerine (Imgur, GitHub assets) yükler. AgentGIF, etiketleme, koleksiyonlar, terminal temaları, tam metin arama ve REST API ile özel barındırma sunar.
Platform Özellikleri
| Özellik | Ayrıntılar |
|---|---|
| GIF Kütüphanesi | 911'den fazla etiket üzerinde 768'den fazla herkese açık terminal GIF'i |
| Terminal Temaları | 44 VHS teması (Catppuccin, Dracula, Tokyo Night, Nord, Solarized ve daha fazlası) |
| Gömme Formatları | Markdown, HTML, iframe, Script widget, oEmbed, SVG Badge |
| CLI Araçları | Python, Node.js, Go, Rust, Ruby — terminalden yükleme, kaydetme, arama |
| REST API | 30'dan fazla endpoint, kimlik doğrulaması olmadan ücretsiz okuma, OpenAPI 3.1 spesifikasyonu |
| Tam Metin Arama | Başlık, komut, etiketler ve döküm içeriğiyle arama |
| Koleksiyonlar | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| Rozet Servisi | PyPI, npm, crates.io ve GitHub için terminal temalı paket rozetleri |
| AI Tape Üreteci | Doğal dil açıklamalarından VHS tape dosyaları oluşturma |
| .md Endpoint'leri | LLM için optimize edilmiş Markdown çıktısı almak için herhangi bir URL'ye .md ekleyin |
| i18n | Makine çevirili meta verilerle 15 dil |
Yapay Zeka Ajanları için Tasarlandı
AgentGIF, yapay zeka ajanlarının tüketimi için sıfırdan tasarlanmıştır. Sitedeki her sayfada temiz Markdown döndüren bir .md endpoint'i bulunur. Platform birden fazla keşif kanalı sunar:
| Kanal | URL | Amaç |
|---|---|---|
| llms.txt | /llms.txt | Yapay zeka tarayıcıları için site yapısı özeti |
| OpenAPI | /api/openapi.json | Tam API şeması (OpenAPI 3.1) |
| RSS/Atom | /feed/ | Feed okuyucuları için en son GIF'ler |
| Site Haritası | /sitemap.xml | Tüm dizine alınmış URL'ler |
| Arama API'si | /api/v1/search/?q=... | Programatik tam metin arama |
Açık Kaynak Ekosistemi
AgentGIF, 5 paket kaydedicisi genelinde CLI araçları ve entegrasyonlar sunar:
| Platform | Paket | Kur |
|---|---|---|
| PyPI | agentgif | pip install agentgif |
| npm | @agentgif/cli | npm install -g @agentgif/cli |
| Go | github.com/agentgif/cli | go install github.com/agentgif/cli@latest |
| Crates.io | agentgif | cargo install agentgif |
| RubyGems | agentgif | gem install agentgif |
Teknoloji
| Katman | Yığın |
|---|---|
| Backend | Django 6.0, Python 3.14, PostgreSQL |
| Frontend | Tailwind CSS, Alpine.js, xterm.js (terminal tekrar oynatma) |
| CDN | Cloudflare R2 (çift kova: statik + yüklemeler) |
| Arama | Ağırlıklı sıralama ile PostgreSQL tam metin arama |
| Kayıt | Charm tarafından VHS (44 terminal teması) |
| Cast Formatı | asciinema v2 (JSON başlığı + zaman damgalı olaylar) |
İletişim
Güvenlik sorunları için security.txt dosyasına bakın. API sorularınız için API referansına bakın. Diğer her şey için [email protected] adresine ulaşın.