AgentGIF について
デュアルレイヤーアーキテクチャによる開発者向け GIF ホスティング: 人間向けの GIF、エージェント向けのキャスト.
AgentGIF とは?
AgentGIF はターミナルデモ GIF 専用に設計されたホスティングプラットフォームです。AgentGIF にアップロードされるすべての GIF には 2 つのレイヤーがあります:
- ビジュアルレイヤー — GitHub README、ドキュメントサイト、ブログ記事でインラインに再生されるアニメーション GIF 画像。JavaScript プレーヤー不要。
- マシンレイヤー — asciinema v2 キャストファイルとプレーンテキストのトランスクリプトがペアになっており、AI エージェントがコマンドを読み取り、出力を理解し、特定のステップを参照できます。
このデュアルレイヤーアプローチにより、単一の URL が両方の対象者に対応します: 人間にはアニメーションのターミナルデモが表示され、AI エージェントは解析・推論できる構造化データを取得します。
なぜ AgentGIF?
ターミナルデモ GIF はオープンソースのドキュメントに広く使われています。しかし、2 つの根本的な問題があります:
- GIF 画像は AI にとって不透明 — AI エージェントが README 内の GIF を見ると、バイナリのピクセルデータしか見えません。コマンドを抽出したり、出力を読んだり、手順を説明したりすることができません。AgentGIF はすべての GIF に機械可読なキャストファイルとトランスクリプトを添付することでこれを解決します。
- 専用ホスティングがない — 開発者はターミナル 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 API | 30+ エンドポイント、認証なしで無料読み取り、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.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 ツールと統合を提供します:
| プラットフォーム | パッケージ | インストール |
|---|---|---|
| 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 |
テクノロジー
| レイヤー | スタック |
|---|---|
| バックエンド | Django 6.0, Python 3.14, PostgreSQL |
| フロントエンド | Tailwind CSS, Alpine.js, xterm.js (ターミナルリプレイ) |
| CDN | Cloudflare R2 (デュアルバケット: 静的ファイル + アップロード) |
| 検索 | 重み付きランキングによる PostgreSQL 全文検索 |
| 録画 | Charm 製 VHS (44 ターミナルテーマ) |
| キャスト形式 | asciinema v2 (JSON ヘッダー + タイムスタンプ付きイベント) |
お問い合わせ
セキュリティの問題については、security.txt をご覧ください。API に関する質問は API リファレンス をご参照ください。その他のお問い合わせは [email protected] までご連絡ください。