Homus

For agents

Homus có sẵn mọi surface một agent cần: llms.txt, bản Markdown của từng trang, RSS, sitemap và một JSON API tĩnh, không cần key.

Surfaces

Tất cả là file tĩnh, đọc bằng một GET, không auth, không rate limit riêng. JSON API trả CORS * và cache 1 giờ.

SurfaceURLDùng khi
llms.txt/llms.txtĐiểm vào ngắn (dưới 10 KB): đọc gì trước, mọi event và topic.
llms-full.txt/llms-full.txtMọi talk trong một file, mỗi talk một dòng, khi cần quét hết.
Markdown twin/talks/{slug}.mdToàn văn một trang: thêm .md vào URL bất kỳ, ví dụ /index.md.
JSON API/api/index.jsonDữ liệu có cấu trúc: talks, topics, events, orgs; index tự mô tả mọi endpoint.
RSS/rss.xmlTheo dõi talk mới.
Sitemap/sitemap.xmlMọi URL kèm lastmod, để chỉ tải lại trang đã đổi.
graph.json/data/graph.jsonĐồ thị org, event, speaker, topic, talk trong một file.
Changelog/changelog.mdVersion signal: dòng mới nhất đổi thì dữ liệu đã đổi.

Snippets

Đọc điểm vào:

curl -s https://homus.dev/llms.txt

Đọc toàn văn một talk bằng Markdown:

curl -s https://homus.dev/talks/agent-output-is-not-ux-rendering-layer-your-llm-pipeline-is-missing.md

Lấy danh sách talk dạng JSON:

curl -s https://homus.dev/api/talks.json

A first session in 4 calls

Ví dụ: tìm talk về sandbox và đọc một talk. Chỉ cần biết /api/index.json, mọi URL còn lại đọc từ response.

# 1. index: endpoints, version, attribution
curl -s https://homus.dev/api/index.json

# 2. talks có topic "Sandboxes"
curl -s https://homus.dev/api/talks.json | jq -r '.talks[] | select(.topics | index("Sandboxes")) | .slug'

# 3. một talk: sections, sources, updated
curl -s https://homus.dev/api/talks/{slug}.json

# 4. toàn văn
curl -s https://homus.dev/talks/{slug}.md

Hiện có 89 talk. Muốn biết có gì mới mà không tải lại hết: so version trong /api/index.json với lần trước, rồi dùng lastmod trong sitemap.

Reuse rules

  • Mỗi talk trên Homus là bản viết lại tiếng Việt của một talk gốc, giữ technical term tiếng Anh. Trích dẫn thì nói rõ đó là bản viết lại, không phải lời nguyên văn của speaker.
  • Ghi nguồn cả hai: link trang talk trên homus.dev, và talk gốc (speaker, sự kiện, video gốc có trong mục nguồn và trong sources của API).
  • Ưu tiên link tới Homus thay vì chép nguyên bài; trả lời ngắn kèm link là đủ.
  • Thấy sai thì báo về [email protected].