image-uploader

# Image Uploader Skill This skill allows uploading local image files to public image hosting services. It supports **sm.ms**, **Imgur**, and **GitHub** (with jsDelivr CDN acceleration). ## Prerequisites 1. **Dependencies**: The skill requires Python 3 and the `requests` library. ```bash pip install -r skills/image-uploader/requirements.txt ``` 2. **Configuration**: An API token or client ID is required depending on the provider. **sm.ms** (default): * **Config File**: `skills/image-uploader/config.json` ```json { "smms_token": "YOUR_TOKEN" } ``` * **Environment Variable**: `SMMS_TOKEN` * **CLI Argument**: `--token` **Imgur**: * **Config File**: `skills/image-uploader/config.json` ```json { "imgur_client_id": "YOUR_CLIENT_ID" } ``` * **Environment Variable**: `IMGUR_CLIENT_ID` * **CLI Argument**: `--token` **GitHub**: * **Config File**: `skills/image-uploader/config.json` ```json { "github_token": "YOUR_GITHUB_TOKEN", "github_owner": "YOUR_GITHUB_USERNAME", "github_repo": "YOUR_IMAGE_REPO_NAME", "github_path": "images", "github_branch": "main", "github_cdn": "jsdelivr" } ``` * **Environment Variables**: `IMAGE_UPLOADER_GITHUB_TOKEN`, `IMAGE_UPLOADER_GITHUB_OWNER`, `IMAGE_UPLOADER_GITHUB_REPO`, `IMAGE_UPLOADER_GITHUB_CDN` * **CLI Argument**: `--token` (for token only) * **CDN Options**: * `"jsdelivr"` — `cdn.jsdelivr.net` (default, international) * `"china"` — `jsd.cdn.zzko.cn` (China mirror) **Default Provider**: Set `default_provider` in `config.json` to `"smms"`, `"imgur"`, or `"github"`, or use the `IMAGE_UPLOADER_PROVIDER` environment variable. ## Usage To upload an image, run the Python script: ```bash python3 skills/image-uploader/image_uploader.py <path_to_image> ``` ### Examples **Upload to sm.ms (default, using config/env token):** ```bash python3 skills/image-uploader/image_uploader.py /Users/me/Pictures/screenshot.png ``` **Upload to Imgur:** ```bash python3 skills/image-uploader/image_uploader.py /Users/me/Pictures/screenshot.png --provider imgur ``` **Upload to GitHub (jsDelivr CDN):** ```bash python3 skills/image-uploader/image_uploader.py /Users/me/Pictures/screenshot.png --provider github ``` **Upload with explicit token:** ```bash python3 skills/image-uploader/image_uploader.py image.png --token "YOUR_API_TOKEN" ``` **Upload to Imgur using env var:** ```bash IMGUR_CLIENT_ID="your_id" python3 skills/image-uploader/image_uploader.py image.png --provider imgur ``` **Upload to GitHub using env vars:** ```bash IMAGE_UPLOADER_GITHUB_TOKEN="your_token" IMAGE_UPLOADER_GITHUB_OWNER="user" IMAGE_UPLOADER_GITHUB_REPO="images" python3 skills/image-uploader/image_uploader.py image.png --provider github ``` ## Output The script outputs the result to stdout. **Success (sm.ms):** ```text ✅ Upload Successful! URL: https://s2.loli.net/2023/01/01/abcdefg.jpg Delete Link: https://sm.ms/delete/xyz123 Filename: screenshot.png ``` **Success (Imgur):** ```text ✅ Upload Successful! URL: https://i.imgur.com/abcdefg.png Delete Hash: AbCdEfGhIjK ``` **Success (GitHub):** ```text ✅ Upload Successful! CDN URL: https://cdn.jsdelivr.net/gh/user/repo@main/images/a1b2c3d4_screenshot.png Raw URL: https://raw.githubusercontent.com/user/repo/main/images/a1b2c3d4_screenshot.png ``` **Already Exists (sm.ms):** ```text ⚠️ Image already exists. URL: https://s2.loli.net/2023/01/01/abcdefg.jpg ``` **Failure:** ```text ❌ Upload Failed Message: Unauthorized. ```