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.

   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

     { "smms_token": "YOUR_TOKEN" }
     

   • Environment Variable: SMMS_TOKEN
   • CLI Argument: --token

   Imgur:

   • Config File: skills/image-uploader/config.json

     { "imgur_client_id": "YOUR_CLIENT_ID" }
     

   • Environment Variable: IMGUR_CLIENT_ID
   • CLI Argument: --token

   GitHub:

   • Config File: skills/image-uploader/config.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:

python3 skills/image-uploader/image_uploader.py <path_to_image>

Examples

Upload to sm.ms (default, using config/env token):

python3 skills/image-uploader/image_uploader.py /Users/me/Pictures/screenshot.png

Upload to Imgur:

python3 skills/image-uploader/image_uploader.py /Users/me/Pictures/screenshot.png --provider imgur

Upload to GitHub (jsDelivr CDN):

python3 skills/image-uploader/image_uploader.py /Users/me/Pictures/screenshot.png --provider github

Upload with explicit token:

python3 skills/image-uploader/image_uploader.py image.png --token "YOUR_API_TOKEN"

Upload to Imgur using env var:

IMGUR_CLIENT_ID="your_id" python3 skills/image-uploader/image_uploader.py image.png --provider imgur

Upload to GitHub using env vars:

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):

✅ Upload Successful!
URL: https://s2.loli.net/2023/01/01/abcdefg.jpg
Delete Link: https://sm.ms/delete/xyz123
Filename: screenshot.png

Success (Imgur):

✅ Upload Successful!
URL: https://i.imgur.com/abcdefg.png
Delete Hash: AbCdEfGhIjK

Success (GitHub):

✅ 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):

⚠️  Image already exists.
URL: https://s2.loli.net/2023/01/01/abcdefg.jpg

Failure:

❌ Upload Failed
Message: Unauthorized.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.