mcpField
A
agent-tools

agent-tools

github.com/beltshOther075 installsUpdated 15w ago
Repository

About agent-tools

inference.sh is a command-line interface for running cloud AI apps, including image, video, and LLM apps, without requiring a GPU. It is aimed at developers and agents, with app discovery, execution, task checks, and automatic upload of local files.

Key features

  1. 01Browse and search the app catalog
  2. 02Run cloud AI apps from the CLI
  3. 03Check task status and run without waiting
  4. 04Upload local files from input paths
  5. 05Use apps across image, video, LLM, and other categories

Use cases

  1. 01Discover an app for a specific task
  2. 02Run an AI app with local media files
  3. 03Launch a task and check its status later
  4. 04Use cloud AI apps without a GPU

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/beltsh/superpowers --skill agent-tools

After installing, type/agent-toolsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
app-discovery.md
authentication.md
cli-reference.md
running-apps.md

Details

From the project README

Install the belt CLI skill: npx skills add belt-sh/cli

inference.sh

Run AI apps in the cloud with a simple CLI. No GPU required.

inference.sh

Install CLI

curl -fsSL https://cli.inference.sh | sh
belt login

What does the installer do? The install script detects your OS and architecture, downloads the correct binary from dist.inference.sh, verifies its SHA-256 checksum, and places it in your PATH. That's it — no elevated permissions, no background processes, no telemetry. If you have cosign installed, the installer also verifies the Sigstore signature automatically.

Manual install (if you prefer not to pipe to sh):

# Download the binary and checksums
curl -LO https://dist.inference.sh/cli/checksums.txt
curl -LO $(curl -fsSL https://dist.inference.sh/cli/manifest.json | grep -o '"url":"[^"]*"' | grep $(uname -s | tr A-Z a-z)-$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/') | head -1 | cut -d'"' -f4)
# Verify checksum
sha256sum -c checksums.txt --ignore-missing
# Extract and install
tar -xzf inferencesh-cli-*.tar.gz
mv inferencesh-cli-* ~/.local/bin/inferencesh

Quick Examples

# Generate an image
belt app run falai/flux-dev-lora --input '{"prompt": "a cat astronaut"}'

# Generate a video
belt app run google/veo-3-1-fast --input '{"prompt": "drone over mountains"}'

# Call Claude
belt app run openrouter/claude-sonnet-45 --input '{"prompt": "Explain quantum computing"}'

# Web search
belt app run tavily/search-assistant --input '{"query": "latest AI news"}'

# Post to Twitter
belt app run x/post-tweet --input '{"text": "Hello from AI!"}'

# Generate 3D model
belt app run infsh/rodin-3d-generator --input '{"prompt": "a wooden chair"}'

Local File Uploads

The CLI automatically uploads local files when you provide a path instead of a URL:

# Upscale a local image
belt app run falai/topaz-image-upscaler --input '{"image": "/path/to/photo.jpg", "upscale_factor": 2}'

# Image-to-video from local file
belt app run falai/wan-2-5-i2v --input '{"image": "./my-image.png", "prompt": "make it move"}'

# Avatar with local audio and image
belt app run bytedance/omnihuman-1-5 --input '{"audio": "/path/to/speech.mp3", "image": "/path/to/face.jpg"}'

# Post tweet with local media
belt app run x/post-create --input '{"text": "Check this out!", "media": "./screenshot.png"}'

Commands

TaskCommand
Browse the app storebelt app list
Search appsbelt app search "flux"
Filter by categorybelt app list --category image
Get app detailsbelt app get google/veo-3-1-fast
Generate sample inputbelt app sample google/veo-3-1-fast --save input.json
Run appbelt app run google/veo-3-1-fast --input input.json
Run without waitingbelt app run <app> --input input.json --no-wait
Check task statusbelt task get <task-id>

What's Available

CategoryExamples
ImageFLUX, Gemini 3 Pro, Grok Imagine, Seedream 4.5, Reve, Topaz Upscaler
VideoVeo 3.1, Seedance 1.5, Wan 2.5, OmniHuman, Fabric, HunyuanVideo Foley
LLMsClaude Opus/Sonnet/Haiku, Gemini 3 Pro, Kimi K2, GLM-4, any OpenRouter model
SearchTavily Search, Tavily Extract, Exa Search, Exa Answer, Exa Extract
3DRodin 3D Generator
Twitter/Xpost-tweet, post-create, dm-send, user-follow, post-like, post-retweet
UtilitiesMedia merger, caption videos, image stitching, audio extraction

Related Skills

# Image generation (FLUX, Gemini, Grok, Seedream)
npx skills add inference-sh/skills@ai-image-generation

# Video generation (Veo, Seedance, Wan, OmniHuman)
npx skills add inference-sh/skills@ai-video-generation

# LLMs (Claude, Gemini, Kimi, GLM via OpenRouter)
npx skills add inference-sh/skills@llm-models

# Web search (Tavily, Exa)
npx skills add inference-sh/skills@web-search

# AI avatars & lipsync (OmniHuman, Fabric, PixVerse)
npx skills add inference-sh/skills@ai-avatar-video

# Twitter/X automation
npx skills add inference-sh/skills@twitter-automation

# Model-specific
npx skills add inference-sh/skills@flux-image
npx skills add inference-sh/skills@google-veo

# Utilities
npx skills add inference-sh/skills@image-upscaling
npx skills add inference-sh/skills@background-removal

Reference Files

Documentation

Comments

Markdown supported