AgentGIF について

デュアルレイヤーアーキテクチャによる開発者向け GIF ホスティング: 人間向けの GIF、エージェント向けのキャスト.

AgentGIF とは?

AgentGIF はターミナルデモ GIF 専用に設計されたホスティングプラットフォームです。AgentGIF にアップロードされるすべての GIF には 2 つのレイヤーがあります:

  • ビジュアルレイヤー — GitHub README、ドキュメントサイト、ブログ記事でインラインに再生されるアニメーション GIF 画像。JavaScript プレーヤー不要。
  • マシンレイヤーasciinema v2 キャストファイルとプレーンテキストのトランスクリプトがペアになっており、AI エージェントがコマンドを読み取り、出力を理解し、特定のステップを参照できます。

このデュアルレイヤーアプローチにより、単一の URL が両方の対象者に対応します: 人間にはアニメーションのターミナルデモが表示され、AI エージェントは解析・推論できる構造化データを取得します。

なぜ AgentGIF?

ターミナルデモ GIF はオープンソースのドキュメントに広く使われています。しかし、2 つの根本的な問題があります:

  1. GIF 画像は AI にとって不透明 — AI エージェントが README 内の GIF を見ると、バイナリのピクセルデータしか見えません。コマンドを抽出したり、出力を読んだり、手順を説明したりすることができません。AgentGIF はすべての GIF に機械可読なキャストファイルとトランスクリプトを添付することでこれを解決します。
  2. 専用ホスティングがない — 開発者はターミナル GIF を汎用画像ホスト (Imgur、GitHub assets) にアップロードしていますが、これらはメタデータを削除し、積極的に圧縮し、検索や整理機能を提供しません。AgentGIF はタグ付け、コレクション、ターミナルテーマ、全文検索、REST API を備えた専用ホスティングを提供します。

プラットフォーム機能

機能詳細
GIF ライブラリ911+ タグにわたる 768+ 件のパブリックターミナル GIF
ターミナルテーマ44 の VHS テーマ (Catppuccin、Dracula、Tokyo Night、Nord、Solarized など)
埋め込み形式Markdown、HTML、iframe、スクリプトウィジェット、oEmbed、SVG バッジ
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 テープジェネレーター自然言語の説明から VHS テープファイルを生成
.md エンドポイント任意の URL に .md を追加して LLM 最適化された Markdown 出力を取得
国際化機械翻訳メタデータを含む 15 言語対応

AI エージェント向けに構築

AgentGIF は AI エージェントの消費を念頭において一から設計されています。サイトのすべてのページにクリーンな Markdown を返す .md エンドポイントがあります。プラットフォームは複数の発見チャネルを提供します:

チャネルURL目的
llms.txt/llms.txtAI クローラー向けのサイト構造サマリー
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 ターミナルテーマ)
キャスト形式asciinema v2 (JSON ヘッダー + タイムスタンプ付きイベント)

お問い合わせ

セキュリティの問題については、security.txt をご覧ください。API に関する質問は API リファレンス をご参照ください。その他のお問い合わせは [email protected] までご連絡ください。