img-bed

GitHub Pages-backed image/document asset repository for Markdown and documentation.

Base URL

• Pages site: https://asunfly.github.io/img-bed/
• Example asset URL: https://asunfly.github.io/img-bed/img/20200503151419.png

Current layout

This repository already contains historical assets in the root, img/, slides/, and other subdirectories. Those files are kept as-is for backward compatibility.

Canonical path for new uploads

New assets should go under:

uploads/<logical-subdir>/YYYY/MM/<timestamp>-<name>-<hash>.<ext>

Example:

uploads/docs/hermes/2026/04/20260420-204230-example-ce4c49a408.png

This keeps future uploads organized without breaking old links.

Default link policy

• If a document already uses a stable public internet image URL, keep it as-is by default.
• Only mirror an image into this repository when explicitly requested or when a local/private image needs hosting.

Local helper script

A local helper script is available on the Hermes machine:

python ~/.hermes/scripts/upload_to_img_bed.py /path/to/file.png --subdir docs/hermes --dry-run
python ~/.hermes/scripts/upload_to_img_bed.py /path/to/file.png --subdir docs/hermes

The script:

• verifies/updates the repo locally
• deduplicates by file hash
• returns the GitHub Pages URL for reuse in Markdown
• stores new files under the canonical uploads/ layout