Perguntas Frequentes

Perguntas comuns sobre o AgentGIF, a plataforma de hospedagem de GIF para desenvolvedores.

O que é o AgentGIF?

O AgentGIF é uma plataforma de hospedagem de GIF para desenvolvedores com arquitetura de camada dupla. Cada GIF de demonstração de terminal é combinado com um arquivo cast asciinema v2 legível por máquina, para que tanto humanos quanto agentes de IA possam entender o conteúdo.

Um humano vê uma gravação animada de terminal. Um agente de IA vê dados estruturados: comandos, saída, timestamps e metadados.

O AgentGIF é gratuito?

Sim. Enviar, hospedar e incorporar GIFs é completamente gratuito. A REST API é gratuita para operações de leitura sem autenticação necessária. As operações de escrita (envio, edição, exclusão) requerem uma chave de API gratuita da sua página de configurações.

O que é um arquivo cast?

Um arquivo cast é uma gravação asciinema v2. É um formato de texto onde a linha 1 é um cabeçalho JSON com metadados do terminal, seguido de tuplas de eventos com timestamp:

{"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"]

Cada tupla é [timestamp_seconds, event_type, data]. Isso permite que agentes de IA extraiam comandos, saída e tempo sem OCR.

Como envio um GIF?

Duas opções:

  • Web: Arraste e solte em /upload/ (requer login no GitHub)
  • CLI: agentgif upload demo.gif --title "My Demo" --tags cli,unix

O CLI está disponível para 5 linguagens: Python, Node.js, Go, Rust e Ruby. Inclua o flag --cast demo.cast para anexar a camada legível por máquina.

Como incorporo um GIF no meu README?

O padrão recomendado para READMEs do GitHub:

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

Substitua ID pelo ID de 8 caracteres do seu GIF. Veja o guia de embed completo para todos os 6 métodos.

O que é o endpoint .md?

Adicione .md a qualquer URL do AgentGIF para obter uma resposta text/markdown otimizada para LLMs. Cada página suporta isso — detalhes de GIF, listagens de tags, páginas de ferramentas, coleções, guias e resultados de pesquisa.

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

Preciso de uma chave de API?

OperaçãoAutenticação Necessária
Pesquisa, listagem, detalhe, cast, transcriçãoNão — completamente aberto
Enviar, editar, excluir GIFsSim — cabeçalho X-API-Key
Criar/gerenciar coleçõesSim — cabeçalho X-API-Key

Obtenha uma chave de API gratuita em /settings/ após entrar com GitHub.

Quais temas de terminal estão disponíveis?

O AgentGIF suporta todos os 44 temas de terminal do VHS. Escolhas populares:

TemaEstilo
Catppuccin MochaEscuro quente com acentos pastéis (padrão)
DraculaClássico roxo escuro
Tokyo NightEscuro moderno focado em azul
NordPaleta azul ártica
Solarized Dark/LightCores de precisão
GitHub Dark/LightTemas nativos do GitHub

Navegue por todos os temas com pré-visualizações ao vivo: Galeria de Temas.

O que é o serviço de badges?

O AgentGIF fornece badges de pacote com tema de terminal como uma alternativa ao shields.io. Eles são renderizados com as cores do tema de terminal escolhido.

![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)

Provedores suportados: PyPI, npm, crates.io, GitHub. Personalize com os parâmetros ?theme= e ?style=. Veja o playground de badges.

Como agentes de IA leem GIFs?

Agentes de IA podem acessar conteúdo de GIF por múltiplos canais:

  • Arquivos cast: GET /api/v1/gifs/{id}/cast/ — gravação asciinema v2 completa com timestamps
  • Transcrições: GET /api/v1/gifs/{id}/transcript/ — texto simples limpo, códigos ANSI removidos
  • endpoints .md: Adicione .md a qualquer URL de página para saída Markdown
  • API JSON: /api/v1/search/?q=docker — pesquisa de texto completo com resultados estruturados
  • llms.txt: /llms.txt — resumo em nível de site para crawlers de IA

Veja a documentação completa de integração com agente de IA.

Quais formatos de arquivo são suportados?

FormatoTamanho MáximoFinalidade
GIF10 MBFormato visual primário — reproduz em todos os lugares
Cast (.cast)5 MBCamada legível por máquina (opcional no upload)
MP4Gerado automaticamenteAlternativa de reprodução eficiente

Para melhores resultados, mantenha os GIFs abaixo de 5 MB. Veja o guia de gravação para dicas de otimização.

Como gravo um GIF de terminal?

Recomendamos o VHS by Charm para gravações scriptadas e reproduzíveis:

# 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

Instruções passo a passo completas: Como Gravar um GIF de Terminal.

← Sobre · Documentação · Guias →