Häufig gestellte Fragen

Was ist AgentGIF?

AgentGIF ist eine Entwickler-GIF-Hosting-Plattform mit Zwei-Schichten-Architektur. Jedes Terminal-Demo-GIF wird mit einer maschinenlesbaren asciinema v2-Cast-Datei gepaart, sodass sowohl Menschen als auch KI-Agenten den Inhalt verstehen können.

Ein Mensch sieht eine animierte Terminalaufnahme. Ein KI-Agent sieht strukturierte Daten: Befehle, Ausgabe, Zeitstempel und Metadaten.

Ist AgentGIF kostenlos?

Ja. Hochladen, Hosting und Einbetten von GIFs ist völlig kostenlos. Die REST-API ist für Leseoperationen kostenlos ohne Authentifizierung. Schreiboperationen (Upload, Bearbeiten, Löschen) erfordern einen kostenlosen API-Schlüssel von Ihrer Einstellungsseite.

Was ist eine Cast-Datei?

Eine Cast-Datei ist eine asciinema v2-Aufnahme. Es ist ein Textformat, bei dem Zeile 1 ein JSON-Header mit Terminal-Metadaten ist, gefolgt von zeitgestempelten Event-Tupeln:

{"version": 2, "width": 120, "height": 40}
[0.5, "o", "$ docker compose up -d\r\n"]
[1.2, "o", "Creating network...\r\n"]
[2.8, "o", "Container app-1  Started\r\n"]

Jedes Tupel ist [timestamp_seconds, event_type, data]. Dies ermöglicht KI-Agenten, Befehle, Ausgabe und Timing ohne OCR zu extrahieren.

Wie lade ich ein GIF hoch?

Zwei Optionen:

• Web: Per Drag-and-Drop unter /upload/ (GitHub-Anmeldung erforderlich)
• CLI: agentgif upload demo.gif --title "My Demo" --tags cli,unix

Die CLI ist für 5 Sprachen verfügbar: Python, Node.js, Go, Rust und Ruby. Verwenden Sie das Flag --cast demo.cast, um die maschinenlesbare Ebene anzuhängen.

Wie bette ich ein GIF in mein README ein?

Das empfohlene Muster für GitHub READMEs:

<p align="center">
  <a href="https://agentgif.com/ID">
    <img src="https://media.agentgif.com/ID.gif" alt="demo" width="800">
  </a>
</p>

Ersetzen Sie ID durch die 8-stellige ID Ihres GIFs. Siehe die vollständige Einbettungsanleitung für alle 6 Methoden.

Was ist der .md-Endpunkt?

Hängen Sie .md an jede AgentGIF-URL an, um eine für LLMs optimierte text/markdown-Antwort zu erhalten. Jede Seite unterstützt dies — GIF-Details, Tag-Listen, Tool-Seiten, Sammlungen, Anleitungen und Suchergebnisse.

curl https://agentgif.com/tools/git/.md
curl https://agentgif.com/explore/tags/docker/.md

Benötige ich einen API-Schlüssel?

Holen Sie sich einen kostenlosen API-Schlüssel unter /settings/ nach der Anmeldung mit GitHub.

Welche Terminal-Themes sind verfügbar?

AgentGIF unterstützt alle 44 VHS-Terminal-Themes. Beliebte Optionen:

Alle Themes mit Live-Vorschau durchstöbern: Theme-Galerie.

Was ist der Badge-Dienst?

AgentGIF bietet Terminal-Themen-Paket-Badges als shields.io-Alternative. Sie werden mit den Farben Ihres gewählten Terminal-Themes gerendert.

![PyPI](https://agentgif.com/badge/pypi/requests/version.svg?theme=dracula)
![npm](https://agentgif.com/badge/npm/express/version.svg?theme=nord)
![Stars](https://agentgif.com/badge/github/torvalds/linux/stars.svg)

Unterstützte Anbieter: PyPI, npm, crates.io, GitHub. Anpassen mit ?theme= und ?style= Parametern. Siehe den Badge-Spielplatz.

Wie lesen KI-Agenten GIFs?

KI-Agenten können auf GIF-Inhalte über mehrere Kanäle zugreifen:

• Cast-Dateien: GET /api/v1/gifs/{id}/cast/ — vollständige asciinema v2-Aufzeichnung mit Zeitstempeln
• Transkripte: GET /api/v1/gifs/{id}/transcript/ — sauberer Klartext, ANSI-Codes entfernt
• .md-Endpunkte: .md an eine beliebige Seiten-URL anhängen für Markdown-Ausgabe
• JSON-API: /api/v1/search/?q=docker — Volltextsuche mit strukturierten Ergebnissen
• llms.txt: /llms.txt — Zusammenfassung auf Seitenebene für KI-Crawler

Siehe die vollständige KI-Agenten-Integrationsdokumentation.

Welche Dateiformate werden unterstützt?

Für beste Ergebnisse halten Sie GIFs unter 5 MB. Siehe die Aufnahmeanleitung für Optimierungstipps.

Wie nehme ich ein Terminal-GIF auf?

Wir empfehlen VHS von Charm für geskriptete, reproduzierbare Aufnahmen:

# Install VHS
brew install vhs

# Create a tape file (demo.tape)
Output demo.gif
Set Theme "Catppuccin Mocha"
Type "echo 'Hello, world!'"
Enter
Sleep 2s

# Record
vhs demo.tape

Vollständige Schritt-für-Schritt-Anleitung: Wie man ein Terminal-GIF aufnimmt.