Über AgentGIF
GIF-Hosting für Entwickler mit Zwei-Schichten-Architektur: GIF für Menschen, Cast für Agenten.
Was ist AgentGIF?
AgentGIF ist eine Hosting-Plattform, die speziell für Terminal-Demo-GIFs entwickelt wurde. Jedes bei AgentGIF hochgeladene GIF hat zwei Schichten:
- Visuelle Schicht — ein animiertes GIF-Bild, das inline in GitHub READMEs, Dokumentationswebsites und Blogbeiträgen abgespielt wird. Kein JavaScript-Player erforderlich.
- Maschinen-Schicht — eine asciinema v2-Cast-Datei, die mit einem Klartext-Transkript gekoppelt ist, damit KI-Agenten die Befehle lesen, die Ausgabe verstehen und bestimmte Schritte referenzieren können.
Dieser Zwei-Schichten-Ansatz bedeutet, dass eine einzige URL beide Zielgruppen bedient: Ein Mensch sieht eine animierte Terminal-Demo, während ein KI-Agent strukturierte Daten erhält, die er parsen und analysieren kann.
Warum AgentGIF?
Terminal-Demo-GIFs sind überall in der Open-Source-Dokumentation. Aber sie haben zwei grundlegende Probleme:
- GIF-Bilder sind für KI undurchsichtig — Wenn ein KI-Agent auf ein GIF in einem README stößt, sieht er binäre Pixeldaten. Er kann die Befehle nicht extrahieren, die Ausgabe lesen oder die Schritte erklären. AgentGIF löst dies, indem maschinenlesbare Cast-Dateien und Transkripte an jedes GIF angehängt werden.
- Kein dediziertes Hosting — Entwickler laden Terminal-GIFs auf generische Bildhoster (Imgur, GitHub Assets) hoch, die Metadaten entfernen, aggressiv komprimieren und keine Suche oder Organisation bieten. AgentGIF bietet zweckgebundenes Hosting mit Tagging, Sammlungen, Terminal-Themes, Volltextsuche und einer REST-API.
Plattform-Funktionen
| Funktion | Details |
|---|---|
| GIF-Bibliothek | 768+ öffentliche Terminal-GIFs über 911+ Tags |
| Terminal-Themes | 44 VHS-Themes (Catppuccin, Dracula, Tokyo Night, Nord, Solarized und mehr) |
| Einbettungsformate | Markdown, HTML, iframe, Script-Widget, oEmbed, SVG-Badge |
| CLI-Tools | Python, Node.js, Go, Rust, Ruby — hochladen, aufnehmen, suchen vom Terminal aus |
| REST API | 30+ Endpunkte, kostenlose Lesezugriffe ohne Authentifizierung, OpenAPI 3.1-Spezifikation |
| Volltextsuche | Suche nach Titel, Befehl, Tags und Transkriptinhalt |
| Sammlungen | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| Badge-Dienst | Terminal-Paket-Badges für PyPI, npm, crates.io und GitHub |
| KI-Tape-Generator | VHS-Tape-Dateien aus natürlichsprachlichen Beschreibungen generieren |
| .md-Endpunkte | Fügen Sie .md an eine beliebige URL an, um LLM-optimierte Markdown-Ausgabe zu erhalten |
| i18n | 15 Sprachen mit maschinell übersetzten Metadaten |
Für KI-Agenten entwickelt
AgentGIF wurde von Grund auf für die KI-Agenten-Nutzung entwickelt. Jede Seite der Website hat einen .md-Endpunkt, der sauberes Markdown zurückgibt. Die Plattform bietet mehrere Entdeckungskanäle:
| Kanal | URL | Zweck |
|---|---|---|
| llms.txt | /llms.txt | Seitenstruktur-Zusammenfassung für KI-Crawler |
| OpenAPI | /api/openapi.json | Vollständiges API-Schema (OpenAPI 3.1) |
| RSS/Atom | /feed/ | Neueste GIFs für Feed-Reader |
| Sitemap | /sitemap.xml | Alle indizierten URLs |
| Such-API | /api/v1/search/?q=... | Programmatische Volltextsuche |
Open-Source-Ökosystem
AgentGIF bietet CLI-Tools und Integrationen über 5 Paket-Registries:
| Plattform | Paket | Installieren |
|---|---|---|
| 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 |
Technologie
| Schicht | Stack |
|---|---|
| Backend | Django 6.0, Python 3.14, PostgreSQL |
| Frontend | Tailwind CSS, Alpine.js, xterm.js (Terminal-Wiedergabe) |
| CDN | Cloudflare R2 (Zwei-Bucket-System: statisch + Uploads) |
| Suche | PostgreSQL-Volltextsuche mit gewichtetem Ranking |
| Aufnahme | VHS von Charm (44 Terminal-Themes) |
| Cast-Format | asciinema v2 (JSON-Header + zeitgestempelte Ereignisse) |
Kontakt
Bei Sicherheitsfragen siehe security.txt. Für API-Fragen siehe die API-Referenz. Für alles andere kontaktieren Sie uns unter [email protected].