เกี่ยวกับ AgentGIF
โฮสติ้ง GIF สำหรับนักพัฒนาด้วยสถาปัตยกรรมสองชั้น: GIF สำหรับมนุษย์ Cast สำหรับ agents.
AgentGIF คืออะไร?
AgentGIF คือแพลตฟอร์มโฮสติ้งที่สร้างขึ้นเพื่อ terminal demo GIFs โดยเฉพาะ GIF ทุกไฟล์ที่อัปโหลดไปยัง AgentGIF มีสองชั้น:
- ชั้นภาพ — ภาพ GIF เคลื่อนไหวที่เล่นได้แบบ inline ใน GitHub READMEs เว็บไซต์เอกสาร และบล็อกโพสต์ ไม่ต้องใช้ JavaScript player
- ชั้นเครื่อง — ไฟล์ asciinema v2 cast คู่กับ transcript แบบข้อความธรรมดา เพื่อให้ AI agents อ่านคำสั่ง เข้าใจผลลัพธ์ และอ้างอิงขั้นตอนเฉพาะได้
วิธีสองชั้นนี้หมายความว่า URL เดียวรองรับทั้งสองกลุ่มผู้ชม: มนุษย์เห็น terminal demo เคลื่อนไหว ขณะที่ AI agent ได้รับข้อมูลที่มีโครงสร้างซึ่งสามารถวิเคราะห์และให้เหตุผลได้
ทำไมต้อง AgentGIF?
Terminal demo GIFs มีอยู่ทั่วไปในเอกสาร open-source แต่มีปัญหาพื้นฐานสองข้อ:
- ภาพ GIF ทึบแสงต่อ AI — เมื่อ AI agent พบ GIF ใน README มันเห็นเพียงข้อมูลพิกเซลแบบ binary ไม่สามารถดึงคำสั่ง อ่านผลลัพธ์ หรืออธิบายขั้นตอนได้ AgentGIF แก้ปัญหานี้โดยแนบไฟล์ cast และ transcript ที่เครื่องอ่านได้กับ GIF ทุกไฟล์
- ไม่มีโฮสติ้งเฉพาะ — นักพัฒนาอัปโหลด terminal GIFs ไปยังโฮสต์รูปภาพทั่วไป (Imgur, GitHub assets) ที่ลบ metadata บีบอัดอย่างหนัก และไม่มีการค้นหาหรือจัดระเบียบ AgentGIF ให้โฮสติ้งเฉพาะพร้อม tagging คอลเลกชัน terminal themes การค้นหาเต็มรูปแบบ และ REST API
ฟีเจอร์แพลตฟอร์ม
| ฟีเจอร์ | รายละเอียด |
|---|---|
| คลัง GIF | 768+ terminal GIFs สาธารณะใน 911+ แท็ก |
| ธีม Terminal | 44 ธีม VHS (Catppuccin, Dracula, Tokyo Night, Nord, Solarized และอื่นๆ) |
| รูปแบบการฝัง | Markdown, HTML, iframe, Script widget, oEmbed, SVG Badge |
| CLI Tools | 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 | Package badges ธีม terminal สำหรับ PyPI, npm, crates.io และ GitHub |
| AI Tape Generator | สร้างไฟล์ VHS tape จากคำอธิบายภาษาธรรมชาติ |
| .md Endpoints | เพิ่ม .md ต่อท้าย URL ใดก็ได้เพื่อรับ Markdown ที่ปรับแต่งสำหรับ LLM |
| i18n | 15 ภาษาพร้อม metadata ที่แปลด้วยเครื่อง |
สร้างสำหรับ AI Agents
AgentGIF ออกแบบตั้งแต่ต้นสำหรับการใช้งานของ AI agent ทุกหน้าในเว็บไซต์มี endpoint .md ที่คืน Markdown ที่สะอาด แพลตฟอร์มมีช่องทางการค้นพบหลายช่องทาง:
| ช่องทาง | URL | วัตถุประสงค์ |
|---|---|---|
| llms.txt | /llms.txt | สรุปโครงสร้างเว็บไซต์สำหรับ AI crawlers |
| OpenAPI | /api/openapi.json | API schema ฉบับสมบูรณ์ (OpenAPI 3.1) |
| RSS/Atom | /feed/ | GIF ล่าสุดสำหรับ feed readers |
| Sitemap | /sitemap.xml | URL ที่จัดทำดัชนีทั้งหมด |
| Search API | /api/v1/search/?q=... | การค้นหาเต็มรูปแบบแบบโปรแกรม |
ระบบนิเวศ Open-Source
AgentGIF ให้ CLI tools และการผสานรวมใน 5 package registries:
| แพลตฟอร์ม | แพ็กเกจ | ติดตั้ง |
|---|---|---|
| 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 |
เทคโนโลยี
| ชั้น | Stack |
|---|---|
| Backend | Django 6.0, Python 3.14, PostgreSQL |
| Frontend | Tailwind CSS, Alpine.js, xterm.js (terminal replay) |
| CDN | Cloudflare R2 (dual bucket: static + uploads) |
| ค้นหา | การค้นหาเต็มรูปแบบ PostgreSQL พร้อมการจัดอันดับแบบถ่วงน้ำหนัก |
| การบันทึก | VHS โดย Charm (44 ธีม terminal) |
| รูปแบบ Cast | asciinema v2 (JSON header + events พร้อม timestamp) |
ติดต่อ
สำหรับปัญหาด้านความปลอดภัย ดู security.txt สำหรับคำถาม API ดู API reference สำหรับเรื่องอื่นๆ ติดต่อที่ [email protected]