О AgentGIF
Хостинг GIF для разработчиков с двухуровневой архитектурой: GIF для людей, Cast для агентов.
Что такое AgentGIF?
AgentGIF — это хостинговая платформа, созданная специально для терминальных демо-GIF. Каждый GIF, загруженный на AgentGIF, имеет два уровня:
- Визуальный уровень — анимированное GIF-изображение, которое воспроизводится прямо в GitHub README, на сайтах документации и в блогах. Не требует JavaScript-плеера.
- Машиночитаемый уровень — файл cast в формате asciinema v2, дополненный текстовой расшифровкой, чтобы ИИ-агенты могли читать команды, понимать вывод и ссылаться на конкретные шаги.
Двухуровневый подход означает, что один URL обслуживает обе аудитории: человек видит анимированный терминальный демо, а ИИ-агент получает структурированные данные, которые может разбирать и анализировать.
Почему AgentGIF?
Терминальные демо-GIF широко используются в документации с открытым исходным кодом. Но у них есть два фундаментальных недостатка:
- GIF-изображения непрозрачны для ИИ — когда ИИ-агент встречает GIF в README, он видит двоичные пиксельные данные. Он не может извлечь команды, прочитать вывод или объяснить шаги. AgentGIF решает эту проблему, прикрепляя машиночитаемые cast-файлы и расшифровки к каждому GIF.
- Нет специализированного хостинга — разработчики загружают терминальные 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 API | 30+ эндпоинтов, бесплатное чтение без аутентификации, спецификация OpenAPI 3.1 |
| Полнотекстовый поиск | Поиск по заголовку, команде, тегам и содержимому расшифровки |
| Коллекции | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| Сервис бейджей | Бейджи пакетов в терминальном стиле для PyPI, npm, crates.io и GitHub |
| Генератор AI Tape | Генерация файлов VHS tape из описаний на естественном языке |
| .md Эндпоинты | Добавьте .md к любому URL для вывода Markdown, оптимизированного для LLM |
| i18n | 15 языков с машинно-переведёнными метаданными |
Создано для ИИ-агентов
AgentGIF разработан с нуля для использования ИИ-агентами. Каждая страница сайта имеет эндпоинт .md, возвращающий чистый Markdown. Платформа предоставляет несколько каналов обнаружения:
| Канал | URL | Назначение |
|---|---|---|
| llms.txt | /llms.txt | Сводка структуры сайта для ИИ-краулеров |
| OpenAPI | /api/openapi.json | Полная схема API (OpenAPI 3.1) |
| RSS/Atom | /feed/ | Последние GIF для агрегаторов |
| Карта сайта | /sitemap.xml | Все индексированные URL |
| Search API | /api/v1/search/?q=... | Программный полнотекстовый поиск |
Экосистема с открытым исходным кодом
AgentGIF предоставляет CLI-инструменты и интеграции для 5 реестров пакетов:
| Платформа | Пакет | Установка |
|---|---|---|
| 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 (двойной bucket: static + uploads) |
| Поиск | Полнотекстовый поиск PostgreSQL с взвешенным ранжированием |
| Запись | VHS от Charm (44 терминальные темы) |
| Формат cast | asciinema v2 (JSON-заголовок + события с метками времени) |
Контакты
По вопросам безопасности см. security.txt. По вопросам API см. справочник API. По остальным вопросам пишите на [email protected].