About AgentGIF
Developer GIF hosting with dual-layer architecture: GIF for humans, Cast for agents.
What is AgentGIF?
AgentGIF is a hosting platform purpose-built for terminal demo GIFs. Every GIF uploaded to AgentGIF has two layers:
- Visual layer — an animated GIF image that plays inline in GitHub READMEs, documentation sites, and blog posts. No JavaScript player required.
- Machine layer — an asciinema v2 cast file paired with a plain-text transcript, so AI agents can read the commands, understand the output, and reference specific steps.
This dual-layer approach means a single URL serves both audiences: a human sees an animated terminal demo, while an AI agent gets structured data it can parse and reason about.
Why AgentGIF?
Terminal demo GIFs are everywhere in open-source documentation. But they have two fundamental problems:
- GIF images are opaque to AI — when an AI agent encounters a GIF in a README, it sees binary pixel data. It can't extract the commands, read the output, or explain the steps. AgentGIF solves this by attaching machine-readable cast files and transcripts to every GIF.
- No dedicated hosting — developers upload terminal GIFs to generic image hosts (Imgur, GitHub assets) that strip metadata, compress aggressively, and offer no search or organization. AgentGIF provides purpose-built hosting with tagging, collections, terminal themes, full-text search, and a REST API.
Platform Features
| Feature | Details |
|---|---|
| GIF Library | 768+ public terminal GIFs across 911+ tags |
| Terminal Themes | 44 VHS themes (Catppuccin, Dracula, Tokyo Night, Nord, Solarized, and more) |
| Embed Formats | Markdown, HTML, iframe, Script widget, oEmbed, SVG Badge |
| CLI Tools | Python, Node.js, Go, Rust, Ruby — upload, record, search from terminal |
| REST API | 30+ endpoints, free reads without authentication, OpenAPI 3.1 spec |
| Full-Text Search | Search by title, command, tags, and transcript content |
| Collections | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| Badge Service | Terminal-themed package badges for PyPI, npm, crates.io, and GitHub |
| AI Tape Generator | Generate VHS tape files from natural language descriptions |
| .md Endpoints | Append .md to any URL for LLM-optimized Markdown output |
| i18n | 15 languages with machine-translated metadata |
Built for AI Agents
AgentGIF is designed from the ground up for AI agent consumption. Every page on the site has a .md endpoint that returns clean Markdown. The platform provides multiple discovery channels:
| Channel | URL | Purpose |
|---|---|---|
| llms.txt | /llms.txt | Site structure summary for AI crawlers |
| OpenAPI | /api/openapi.json | Full API schema (OpenAPI 3.1) |
| RSS/Atom | /feed/ | Latest GIFs for feed readers |
| Sitemap | /sitemap.xml | All indexed URLs |
| Search API | /api/v1/search/?q=... | Programmatic full-text search |
Open-Source Ecosystem
AgentGIF provides CLI tools and integrations across 5 package registries:
| Platform | Package | Install |
|---|---|---|
| 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 |
Technology
| Layer | Stack |
|---|---|
| Backend | Django 6.0, Python 3.14, PostgreSQL |
| Frontend | Tailwind CSS, Alpine.js, xterm.js (terminal replay) |
| CDN | Cloudflare R2 (dual bucket: static + uploads) |
| Search | PostgreSQL full-text search with weighted ranking |
| Recording | VHS by Charm (44 terminal themes) |
| Cast Format | asciinema v2 (JSON header + timestamped events) |
Contact
For security issues, see security.txt. For API questions, see the API reference. For everything else, reach out at [email protected].