关于 AgentGIF

面向开发者的 GIF 托管平台,采用双层架构: GIF 供人类查看,Cast 供代理解析.

什么是 AgentGIF?

AgentGIF 是专为终端演示 GIF 而构建的托管平台。上传到 AgentGIF 的每个 GIF 都包含两层:

  • 视觉层 — 一张可在 GitHub README、文档网站和博客文章中内嵌播放的 GIF 动图,无需 JavaScript 播放器。
  • 机器层 — 一个 asciinema v2 cast 文件,并附有纯文本转录,使 AI 代理可以读取命令、理解输出并引用具体步骤。

这种双层方式意味着一个 URL 同时服务两类受众:人类看到动态终端演示,AI 代理则获得可解析和推理的结构化数据。

为什么选择 AgentGIF?

终端演示 GIF 在开源文档中随处可见,但它们存在两个根本问题:

  1. GIF 图像对 AI 不透明 — 当 AI 代理在 README 中遇到 GIF 时,它只能看到二进制像素数据,无法提取命令、读取输出或解释步骤。AgentGIF 通过为每个 GIF 附加机器可读的 cast 文件和转录来解决这一问题。
  2. 缺乏专用托管 — 开发者将终端 GIF 上传到通用图片托管服务(如 Imgur、GitHub assets),这些服务会删除元数据、过度压缩,且不提供搜索或整理功能。AgentGIF 提供专用托管,支持标签、合集、终端主题、全文搜索和 REST API。

平台功能

功能详情
GIF 库768+ 个公开终端 GIF,涵盖 911+ 个标签
终端主题44 种 VHS 主题(Catppuccin、Dracula、Tokyo Night、Nord、Solarized 等)
嵌入格式Markdown、HTML、iframe、Script 小部件、oEmbed、SVG Badge
CLI 工具Python、Node.js、Go、Rust、Ruby — 在终端中上传、录制、搜索
REST API30+ 个端点,无需认证即可免费读取,提供 OpenAPI 3.1 规范
全文搜索按标题、命令、标签和转录内容搜索
合集Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows")
徽章服务适用于 PyPI、npm、crates.io 和 GitHub 的终端主题包徽章
AI Tape 生成器根据自然语言描述生成 VHS tape 文件
.md 端点在任意 URL 后附加 .md,获取针对 LLM 优化的 Markdown 输出
国际化支持 15 种语言,附机器翻译元数据

为 AI 代理而生

AgentGIF 从底层设计上就面向 AI 代理使用。网站每个页面都有一个 .md 端点,返回整洁的 Markdown 内容。平台提供多种发现渠道:

渠道URL用途
llms.txt/llms.txt面向 AI 爬虫的网站结构摘要
OpenAPI/api/openapi.json完整 API 架构(OpenAPI 3.1)
RSS/Atom/feed/最新 GIF(供订阅阅读器使用)
网站地图/sitemap.xml所有已索引的 URL
搜索 API/api/v1/search/?q=...程序化全文搜索

开源生态系统

AgentGIF 在 5 个包注册表中提供 CLI 工具和集成:

平台安装
PyPIagentgifpip install agentgif
npm@agentgif/clinpm install -g @agentgif/cli
Gogithub.com/agentgif/cligo install github.com/agentgif/cli@latest
Crates.ioagentgifcargo install agentgif
RubyGemsagentgifgem install agentgif

技术栈

技术栈
后端Django 6.0, Python 3.14, PostgreSQL
前端Tailwind CSS, Alpine.js, xterm.js (终端回放)
CDNCloudflare R2 (双存储桶:静态资源 + 上传文件)
搜索PostgreSQL 全文搜索,支持权重排名
录制Charm 出品的 VHS(44 种终端主题)
Cast 格式asciinema v2(JSON 头部 + 带时间戳的事件)

联系我们

安全问题请参阅 security.txt。API 问题请查阅 API 参考文档。其他事宜请联系 [email protected]