Tentang AgentGIF
Hosting GIF untuk developer dengan arsitektur dua lapis: GIF untuk manusia, Cast untuk agen.
Apa itu AgentGIF?
AgentGIF adalah platform hosting yang dirancang khusus untuk GIF demo terminal. Setiap GIF yang diunggah ke AgentGIF memiliki dua lapisan:
- Lapisan visual — gambar GIF animasi yang diputar langsung di GitHub README, situs dokumentasi, dan posting blog. Tidak perlu pemutar JavaScript.
- Lapisan mesin — file cast asciinema v2 yang disertai transkrip teks biasa, sehingga agen AI dapat membaca perintah, memahami output, dan merujuk langkah-langkah tertentu.
Pendekatan dua lapis ini berarti satu URL melayani kedua audiens: manusia melihat demo terminal animasi, sementara agen AI mendapatkan data terstruktur yang dapat diurai dan dipahami.
Mengapa AgentGIF?
GIF demo terminal ada di mana-mana dalam dokumentasi open-source. Namun ada dua masalah mendasar:
- Gambar GIF tidak transparan untuk AI — ketika agen AI menemukan GIF dalam README, ia hanya melihat data piksel biner. Ia tidak dapat mengekstrak perintah, membaca output, atau menjelaskan langkah-langkahnya. AgentGIF mengatasi masalah ini dengan melampirkan file cast dan transkrip yang dapat dibaca mesin ke setiap GIF.
- Tidak ada hosting khusus — developer mengunggah GIF terminal ke host gambar umum (Imgur, aset GitHub) yang menghapus metadata, mengompresi secara agresif, dan tidak menawarkan pencarian atau pengorganisasian. AgentGIF menyediakan hosting yang dibuat khusus dengan penandaan, koleksi, tema terminal, pencarian teks lengkap, dan REST API.
Fitur Platform
| Fitur | Detail |
|---|---|
| Perpustakaan GIF | 768+ GIF terminal publik di 911+ tag |
| Tema Terminal | 44 tema VHS (Catppuccin, Dracula, Tokyo Night, Nord, Solarized, dan lainnya) |
| Format Embed | Markdown, HTML, iframe, widget Script, oEmbed, Badge SVG |
| Alat CLI | Python, Node.js, Go, Rust, Ruby — unggah, rekam, cari dari terminal |
| REST API | 30+ endpoint, baca gratis tanpa autentikasi, spesifikasi OpenAPI 3.1 |
| Pencarian Teks Lengkap | Cari berdasarkan judul, perintah, tag, dan konten transkrip |
| Koleksi | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| Layanan Badge | Badge paket bertema terminal untuk PyPI, npm, crates.io, dan GitHub |
| Generator Tape AI | Buat file tape VHS dari deskripsi bahasa alami |
| Endpoint .md | Tambahkan .md ke URL mana pun untuk output Markdown yang dioptimalkan untuk LLM |
| i18n | 15 bahasa dengan metadata hasil terjemahan mesin |
Dibuat untuk Agen AI
AgentGIF dirancang dari awal untuk konsumsi agen AI. Setiap halaman di situs memiliki endpoint .md yang mengembalikan Markdown yang bersih. Platform ini menyediakan beberapa saluran penemuan:
| Saluran | URL | Tujuan |
|---|---|---|
| llms.txt | /llms.txt | Ringkasan struktur situs untuk crawler AI |
| OpenAPI | /api/openapi.json | Skema API lengkap (OpenAPI 3.1) |
| RSS/Atom | /feed/ | GIF terbaru untuk pembaca umpan |
| Peta Situs | /sitemap.xml | Semua URL yang diindeks |
| API Pencarian | /api/v1/search/?q=... | Pencarian teks lengkap secara programatik |
Ekosistem Open-Source
AgentGIF menyediakan alat CLI dan integrasi di 5 registri paket:
| Platform | Paket | Instalasi |
|---|---|---|
| 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 |
Teknologi
| Lapisan | Stack |
|---|---|
| Backend | Django 6.0, Python 3.14, PostgreSQL |
| Frontend | Tailwind CSS, Alpine.js, xterm.js (pemutaran ulang terminal) |
| CDN | Cloudflare R2 (dua bucket: statis + unggahan) |
| Cari | Pencarian teks lengkap PostgreSQL dengan peringkat berbobot |
| Perekaman | VHS oleh Charm (44 tema terminal) |
| Format Cast | asciinema v2 (header JSON + event bertanda waktu) |
Kontak
Untuk masalah keamanan, lihat security.txt. Untuk pertanyaan API, lihat referensi API. Untuk hal lainnya, hubungi [email protected].