अक्सर पूछे जाने वाले प्रश्न
AgentGIF, डेवलपर GIF होस्टिंग प्लेटफॉर्म के बारे में सामान्य प्रश्न।
AgentGIF क्या है?
AgentGIF एक डेवलपर GIF होस्टिंग प्लेटफॉर्म है जिसमें दोहरी परत वास्तुकला है। प्रत्येक terminal demo GIF एक मशीन-पठनीय asciinema v2 cast फ़ाइल के साथ युग्मित है, ताकि इंसान और AI एजेंट दोनों सामग्री समझ सकें।
एक इंसान एनिमेटेड terminal रिकॉर्डिंग देखता है। एक AI एजेंट संरचित डेटा देखता है: कमांड, आउटपुट, timestamp और मेटाडेटा।
क्या AgentGIF मुफ्त है?
हाँ। GIF अपलोड करना, होस्ट करना और embed करना पूरी तरह मुफ्त है। REST API पढ़ने के संचालन के लिए मुफ्त है, कोई प्रमाणीकरण आवश्यक नहीं। लिखने के संचालन (अपलोड, संपादित, हटाना) के लिए आपके settings पेज से मुफ्त API कुंजी की आवश्यकता है।
Cast फ़ाइल क्या है?
Cast फ़ाइल एक asciinema v2 रिकॉर्डिंग है। यह एक पाठ प्रारूप है जहां पंक्ति 1 terminal मेटाडेटा के साथ JSON header है, उसके बाद timestamp वाले event tuples हैं:
{"version": 2, "width": 120, "height": 40}
[0.5, "o", "$ docker compose up -d\r\n"]
[1.2, "o", "Creating network...\r\n"]
[2.8, "o", "Container app-1 Started\r\n"]
प्रत्येक tuple [timestamp_seconds, event_type, data] है। यह AI एजेंटों को OCR के बिना कमांड, आउटपुट और टाइमिंग निकालने में सक्षम बनाता है।
मैं GIF कैसे अपलोड करूं?
दो विकल्प:
- वेब: /upload/ पर drag और drop करें (GitHub लॉगिन आवश्यक)
- CLI:
agentgif upload demo.gif --title "My Demo" --tags cli,unix
CLI 5 भाषाओं के लिए उपलब्ध है: Python, Node.js, Go, Rust, और Ruby। मशीन-पठनीय परत संलग्न करने के लिए --cast demo.cast flag शामिल करें।
मैं अपने README में GIF कैसे embed करूं?
GitHub README के लिए अनुशंसित पैटर्न:
<p align="center">
<a href="https://agentgif.com/ID">
<img src="https://media.agentgif.com/ID.gif" alt="demo" width="800">
</a>
</p>
ID को अपने GIF की 8-अक्षर ID से बदलें। सभी 6 तरीकों के लिए पूरी embed गाइड देखें।
.md endpoint क्या है?
LLM के लिए अनुकूलित text/markdown प्रतिक्रिया पाने के लिए किसी भी AgentGIF URL में .md जोड़ें। प्रत्येक पेज इसका समर्थन करता है — GIF विवरण, टैग सूची, टूल पेज, संग्रह, गाइड और खोज परिणाम।
curl https://agentgif.com/tools/git/.md
curl https://agentgif.com/explore/tags/docker/.md
क्या मुझे API कुंजी की आवश्यकता है?
| संचालन | प्रमाणीकरण आवश्यक |
|---|---|
| खोज, सूची, विवरण, cast, transcript | नहीं — पूरी तरह खुला |
| GIF अपलोड, संपादित, हटाएं | हाँ — X-API-Key header |
| संग्रह बनाएं/प्रबंधित करें | हाँ — X-API-Key header |
GitHub से साइन इन करने के बाद /settings/ पर मुफ्त API कुंजी पाएं।
कौन से terminal थीम उपलब्ध हैं?
AgentGIF सभी 44 VHS terminal थीम का समर्थन करता है। लोकप्रिय विकल्प:
| थीम | स्टाइल |
|---|---|
| Catppuccin Mocha | pastel accents के साथ गर्म डार्क (डिफ़ॉल्ट) |
| Dracula | डार्क बैंगनी क्लासिक |
| Tokyo Night | नीले-केंद्रित आधुनिक डार्क |
| Nord | आर्कटिक नीला पैलेट |
| Solarized Dark/Light | सटीक रंग |
| GitHub Dark/Light | GitHub की मूल थीम |
लाइव पूर्वावलोकन के साथ सभी थीम ब्राउज़ करें: थीम गैलरी।
Badge सेवा क्या है?
AgentGIF shields.io विकल्प के रूप में terminal-थीम्ड पैकेज badge प्रदान करता है। वे आपके चुने गए terminal थीम रंगों के साथ रेंडर होते हैं।



समर्थित प्रदाता: PyPI, npm, crates.io, GitHub। ?theme= और ?style= params के साथ कस्टमाइज़ करें। badge playground देखें।
AI एजेंट GIF कैसे पढ़ते हैं?
AI एजेंट कई चैनलों के माध्यम से GIF सामग्री तक पहुंच सकते हैं:
- Cast फ़ाइलें:
GET /api/v1/gifs/{id}/cast/— timestamp के साथ पूर्ण asciinema v2 रिकॉर्डिंग - Transcript:
GET /api/v1/gifs/{id}/transcript/— स्वच्छ सादा पाठ, ANSI कोड हटाए गए - .md endpoints: Markdown आउटपुट के लिए किसी भी पेज URL में
.mdजोड़ें - JSON API:
/api/v1/search/?q=docker— संरचित परिणामों के साथ फुल-टेक्स्ट खोज - llms.txt:
/llms.txt— AI क्रॉलर के लिए साइट-स्तरीय सारांश
पूरे AI agent एकीकरण docs देखें।
कौन से फ़ाइल प्रारूप समर्थित हैं?
| प्रारूप | अधिकतम आकार | उद्देश्य |
|---|---|---|
| GIF | 10 MB | प्राथमिक दृश्य प्रारूप — हर जगह चलता है |
| Cast (.cast) | 5 MB | मशीन-पठनीय परत (अपलोड पर वैकल्पिक) |
| MP4 | स्वतः-उत्पन्न | कुशल प्लेबैक विकल्प |
सर्वोत्तम परिणामों के लिए, GIF को 5 MB से कम रखें। अनुकूलन सुझावों के लिए रिकॉर्डिंग गाइड देखें।
मैं terminal GIF कैसे रिकॉर्ड करूं?
हम scripted, पुनरुत्पादन योग्य रिकॉर्डिंग के लिए Charm द्वारा VHS की अनुशंसा करते हैं:
# Install VHS
brew install vhs
# Create a tape file (demo.tape)
Output demo.gif
Set Theme "Catppuccin Mocha"
Type "echo 'Hello, world!'"
Enter
Sleep 2s
# Record
vhs demo.tape
पूर्ण चरण-दर-चरण निर्देश: Terminal GIF कैसे रिकॉर्ड करें।