AgentGIF के बारे में
दोहरी परत वास्तुकला के साथ डेवलपर GIF होस्टिंग: इंसानों के लिए GIF, एजेंटों के लिए Cast.
AgentGIF क्या है?
AgentGIF एक होस्टिंग प्लेटफॉर्म है जो विशेष रूप से terminal demo GIF के लिए बनाया गया है। AgentGIF पर अपलोड किए गए प्रत्येक GIF में दो परतें होती हैं:
- दृश्य परत — एक एनिमेटेड GIF चित्र जो GitHub README, दस्तावेज़ीकरण साइटों और ब्लॉग पोस्ट में इनलाइन चलता है। किसी JavaScript प्लेयर की आवश्यकता नहीं।
- मशीन परत — एक asciinema v2 cast फ़ाइल जो एक सादे-पाठ transcript के साथ युग्मित है, ताकि AI एजेंट कमांड पढ़ सकें, आउटपुट समझ सकें और विशिष्ट चरणों का संदर्भ दे सकें।
इस दोहरे-परत दृष्टिकोण का अर्थ है कि एक ही URL दोनों दर्शकों की सेवा करता है: एक इंसान एनिमेटेड terminal demo देखता है, जबकि AI एजेंट को संरचित डेटा मिलता है जिसे वह पार्स और विश्लेषण कर सकता है।
AgentGIF क्यों?
Terminal demo GIF ओपन-सोर्स दस्तावेज़ीकरण में हर जगह हैं। लेकिन उनमें दो मूलभूत समस्याएं हैं:
- GIF चित्र AI के लिए अपारदर्शी हैं — जब एक AI एजेंट README में GIF का सामना करता है, तो वह बाइनरी पिक्सेल डेटा देखता है। वह कमांड निकाल नहीं सकता, आउटपुट पढ़ नहीं सकता, या चरणों की व्याख्या नहीं कर सकता। AgentGIF इसे प्रत्येक GIF से मशीन-पठनीय cast फ़ाइलें और transcript जोड़कर हल करता है।
- कोई समर्पित होस्टिंग नहीं — डेवलपर terminal GIF को सामान्य इमेज होस्ट (Imgur, GitHub assets) पर अपलोड करते हैं जो मेटाडेटा हटा देते हैं, आक्रामक रूप से संपीड़ित करते हैं और कोई खोज या संगठन प्रदान नहीं करते। AgentGIF टैगिंग, संग्रह, terminal थीम, फुल-टेक्स्ट खोज और REST API के साथ उद्देश्य-निर्मित होस्टिंग प्रदान करता है।
प्लेटफॉर्म सुविधाएं
| सुविधा | विवरण |
|---|---|
| GIF लाइब्रेरी | 911+ टैग में 768+ सार्वजनिक terminal GIF |
| Terminal थीम | 44 VHS थीम (Catppuccin, Dracula, Tokyo Night, Nord, Solarized, और अधिक) |
| Embed प्रारूप | Markdown, HTML, iframe, Script widget, oEmbed, SVG Badge |
| CLI टूल | Python, Node.js, Go, Rust, Ruby — terminal से अपलोड, रिकॉर्ड, खोज करें |
| REST API | 30+ endpoints, प्रमाणीकरण के बिना मुफ्त पढ़ना, OpenAPI 3.1 spec |
| फुल-टेक्स्ट खोज | शीर्षक, कमांड, टैग और transcript सामग्री द्वारा खोजें |
| संग्रह | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| Badge सेवा | PyPI, npm, crates.io और GitHub के लिए terminal-थीम्ड पैकेज badge |
| AI Tape जनरेटर | प्राकृतिक भाषा विवरण से VHS tape फ़ाइलें बनाएं |
| .md Endpoints | LLM-अनुकूलित Markdown आउटपुट के लिए किसी भी URL में .md जोड़ें |
| i18n | मशीन-अनुवादित मेटाडेटा के साथ 15 भाषाएं |
AI एजेंटों के लिए निर्मित
AgentGIF को शुरू से AI एजेंट उपयोग के लिए डिज़ाइन किया गया है। साइट का हर पेज एक .md endpoint रखता है जो स्वच्छ Markdown लौटाता है। प्लेटफॉर्म कई खोज चैनल प्रदान करता है:
| चैनल | URL | उद्देश्य |
|---|---|---|
| llms.txt | /llms.txt | AI क्रॉलर के लिए साइट संरचना सारांश |
| OpenAPI | /api/openapi.json | पूर्ण API schema (OpenAPI 3.1) |
| RSS/Atom | /feed/ | फीड पाठकों के लिए नवीनतम GIF |
| Sitemap | /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 (terminal replay) |
| CDN | Cloudflare R2 (दोहरी बकेट: static + uploads) |
| खोज | भारित रैंकिंग के साथ PostgreSQL फुल-टेक्स्ट खोज |
| रिकॉर्डिंग | Charm द्वारा VHS (44 terminal थीम) |
| Cast प्रारूप | asciinema v2 (JSON header + टाइमस्टैम्पड इवेंट) |
संपर्क
सुरक्षा मुद्दों के लिए, security.txt देखें। API प्रश्नों के लिए, API संदर्भ देखें। बाकी सब के लिए, [email protected] पर संपर्क करें।