AgentGIF 소개
이중 레이어 아키텍처를 갖춘 개발자용 GIF 호스팅: 사람을 위한 GIF, 에이전트를 위한 Cast.
AgentGIF이란?
AgentGIF은 터미널 데모 GIF를 위해 특별히 설계된 호스팅 플랫폼입니다. AgentGIF에 업로드된 모든 GIF에는 두 가지 레이어가 있습니다:
- 시각적 레이어 — GitHub README, 문서 사이트, 블로그 포스트에 인라인으로 재생되는 애니메이션 GIF 이미지. JavaScript 플레이어가 필요 없습니다.
- 머신 레이어 — asciinema v2 cast 파일과 일반 텍스트 전사본이 결합되어, AI 에이전트가 명령어를 읽고, 출력을 이해하며, 특정 단계를 참조할 수 있습니다.
이 이중 레이어 접근 방식은 하나의 URL이 두 대상 모두에게 서비스됨을 의미합니다: 사람은 애니메이션 터미널 데모를 보고, AI 에이전트는 파싱하고 추론할 수 있는 구조화된 데이터를 얻습니다.
왜 AgentGIF인가?
터미널 데모 GIF는 오픈소스 문서 곳곳에 있습니다. 하지만 두 가지 근본적인 문제가 있습니다:
- GIF 이미지는 AI에게 불투명함 — AI 에이전트가 README에서 GIF를 만나면 이진 픽셀 데이터만 볼 뿐입니다. 명령어를 추출하거나, 출력을 읽거나, 단계를 설명할 수 없습니다. AgentGIF는 모든 GIF에 기계 판독 가능한 cast 파일과 전사본을 첨부하여 이 문제를 해결합니다.
- 전용 호스팅 없음 — 개발자들은 터미널 GIF를 메타데이터를 제거하고, 과도하게 압축하며, 검색이나 구성 기능이 없는 일반 이미지 호스트(Imgur, GitHub assets)에 업로드합니다. AgentGIF는 태그, 컬렉션, 터미널 테마, 전문 검색, REST API를 갖춘 전용 호스팅을 제공합니다.
플랫폼 기능
| 기능 | 세부 사항 |
|---|---|
| GIF 라이브러리 | 911개+ 태그에 걸쳐 768개+ 공개 터미널 GIF |
| 터미널 테마 | 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") |
| Badge 서비스 | PyPI, npm, crates.io, GitHub를 위한 터미널 테마 패키지 Badge |
| AI Tape 생성기 | 자연어 설명으로 VHS tape 파일 생성 |
| .md 엔드포인트 | 모든 URL에 .md를 추가하면 LLM에 최적화된 Markdown 출력 |
| i18n | 기계 번역 메타데이터를 포함한 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 (이중 버킷: static + uploads) |
| 검색 | 가중치 랭킹이 적용된 PostgreSQL 전문 검색 |
| 녹화 | Charm의 VHS (44개 터미널 테마) |
| Cast 형식 | asciinema v2 (JSON 헤더 + 타임스탬프 이벤트) |
연락처
보안 문제는 security.txt를 참조하세요. API 관련 질문은 API 레퍼런스를 참조하세요. 그 외 문의는 [email protected]으로 연락해 주세요.