Sobre o AgentGIF
Hospedagem de GIF para desenvolvedores com arquitetura de camada dupla: GIF para humanos, Cast para agentes.
O que é o AgentGIF?
AgentGIF é uma plataforma de hospedagem criada especificamente para GIFs de demonstração de terminal. Todo GIF enviado ao AgentGIF possui duas camadas:
- Camada visual — uma imagem GIF animada que reproduz inline em READMEs do GitHub, sites de documentação e posts de blog. Nenhum player JavaScript necessário.
- Camada de máquina — um arquivo cast asciinema v2 combinado com uma transcrição em texto simples, para que agentes de IA possam ler os comandos, entender a saída e referenciar etapas específicas.
Essa abordagem de camada dupla significa que uma única URL serve a dois públicos: um humano vê uma demonstração animada do terminal, enquanto um agente de IA obtém dados estruturados que pode analisar e sobre os quais pode raciocinar.
Por que AgentGIF?
GIFs de demonstração de terminal estão em toda parte na documentação de código aberto. Mas eles têm dois problemas fundamentais:
- Imagens GIF são opacas para IA — quando um agente de IA encontra um GIF em um README, ele vê dados binários de pixels. Não consegue extrair os comandos, ler a saída ou explicar as etapas. O AgentGIF resolve isso anexando arquivos cast legíveis por máquina e transcrições a cada GIF.
- Sem hospedagem dedicada — os desenvolvedores enviam GIFs de terminal para hosts de imagens genéricos (Imgur, assets do GitHub) que removem metadados, comprimem agressivamente e não oferecem pesquisa ou organização. O AgentGIF oferece hospedagem especializada com tags, coleções, temas de terminal, pesquisa de texto completo e uma REST API.
Recursos da Plataforma
| Recurso | Detalhes |
|---|---|
| Biblioteca de GIFs | 768+ GIFs de terminal públicos em 911+ tags |
| Temas de Terminal | 44 temas VHS (Catppuccin, Dracula, Tokyo Night, Nord, Solarized e mais) |
| Formatos de Embed | Markdown, HTML, iframe, widget Script, oEmbed, Badge SVG |
| Ferramentas CLI | Python, Node.js, Go, Rust, Ruby — enviar, gravar, pesquisar pelo terminal |
| REST API | 30+ endpoints, leituras gratuitas sem autenticação, spec OpenAPI 3.1 |
| Pesquisa de Texto Completo | Pesquisar por título, comando, tags e conteúdo da transcrição |
| Coleções | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| Serviço de Badges | Badges de pacote com tema de terminal para PyPI, npm, crates.io e GitHub |
| Gerador de Tape para IA | Gerar arquivos de tape VHS a partir de descrições em linguagem natural |
| Endpoints .md | Adicione .md a qualquer URL para saída Markdown otimizada para LLMs |
| i18n | 15 idiomas com metadados traduzidos por máquina |
Construído para Agentes de IA
O AgentGIF foi projetado do zero para consumo por agentes de IA. Cada página do site possui um endpoint .md que retorna Markdown limpo. A plataforma oferece múltiplos canais de descoberta:
| Canal | URL | Finalidade |
|---|---|---|
| llms.txt | /llms.txt | Resumo da estrutura do site para crawlers de IA |
| OpenAPI | /api/openapi.json | Schema completo da API (OpenAPI 3.1) |
| RSS/Atom | /feed/ | GIFs mais recentes para leitores de feed |
| Sitemap | /sitemap.xml | Todas as URLs indexadas |
| API de Pesquisa | /api/v1/search/?q=... | Pesquisa de texto completo programática |
Ecossistema de Código Aberto
O AgentGIF fornece ferramentas CLI e integrações em 5 registros de pacotes:
| Plataforma | Pacote | Instalação |
|---|---|---|
| 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 |
Tecnologia
| Camada | Stack |
|---|---|
| Backend | Django 6.0, Python 3.14, PostgreSQL |
| Frontend | Tailwind CSS, Alpine.js, xterm.js (reprodução de terminal) |
| CDN | Cloudflare R2 (bucket duplo: estático + uploads) |
| Pesquisa | Pesquisa de texto completo no PostgreSQL com ranking ponderado |
| Gravação | VHS by Charm (44 temas de terminal) |
| Formato Cast | asciinema v2 (cabeçalho JSON + eventos com timestamp) |
Contato
Para questões de segurança, veja security.txt. Para dúvidas sobre a API, veja a referência da API. Para todo o resto, entre em contato em [email protected].