About infsh-cli
A CLI for running cloud-hosted AI apps through inference.sh, for developers and agents who need access to image, video, LLM, search, and other app categories. It supports app discovery, execution, task checks, and automatic uploads of local input files.
Key features
- 01Browse and search the app store
- 02Run apps with JSON input
- 03Upload local input files automatically
- 04Run without waiting and check tasks
- 05Generate sample app inputs
Use cases
- 01Generate images or videos from prompts
- 02Call an LLM app from the command line
- 03Upscale an image stored locally
- 04Find an app and prepare its input
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ 101-skills/ superpowers --skill infsh-cliAfter installing, type/infsh-cliin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/app-discovery.mdauthentication.mdcli-reference.mdrunning-apps.mdDetails
From the project READMEInstall 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.

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
| Task | Command |
|---|---|
| Browse the app store | belt app list |
| Search the store | belt app search "flux" |
| Filter by category | belt app list --category image |
| List your apps | belt app list |
| Get app details | belt app get google/veo-3-1-fast |
| Generate sample input | belt app sample google/veo-3-1-fast --save input.json |
| Run app | belt app run google/veo-3-1-fast --input input.json |
| Run without waiting | belt app run <app> --input input.json --no-wait |
| Check task status | belt task get <task-id> |
What's Available
| Category | Examples |
|---|---|
| Image | FLUX, Gemini 3 Pro, Grok Imagine, Seedream 4.5, Reve, Topaz Upscaler |
| Video | Veo 3.1, Seedance 2.0, Wan 2.5, OmniHuman, Fabric, HunyuanVideo Foley |
| LLMs | Claude Opus/Sonnet/Haiku, Gemini 3 Pro, Kimi K2, GLM-4, any OpenRouter model |
| Search | Tavily Search, Tavily Extract, Exa Search, Exa Answer, Exa Extract |
| 3D | Rodin 3D Generator |
| Twitter/X | post-tweet, post-create, dm-send, user-follow, post-like, post-retweet |
| Utilities | Media 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
- Agent Skills Overview - The open standard for AI capabilities
- Getting Started - Introduction to inference.sh
- What is inference.sh? - Platform overview
- Apps Overview - Understanding the app ecosystem
- CLI Setup - Installing the CLI
- Workflows vs Agents - When to use each
- Why Agent Runtimes Matter - Runtime benefits