inference-sh-cli

1---2name: inference-sh-cli3description: Run 150+ AI apps (image, video, LLM) via inference.sh CLI.4version: 1.0.05author: okaris6license: MIT7platforms: [linux, macos, windows]8metadata:9  hermes:10    tags: [AI, image-generation, video, LLM, search, inference, FLUX, Veo, Claude]11    related_skills: []12---13 14# inference.sh CLI15 16Run 150+ AI apps in the cloud with a simple CLI. No GPU required.17 18All commands use the **terminal tool** to run `infsh` commands.19 20## When to Use21 22- User asks to generate images (FLUX, Reve, Seedream, Grok, Gemini image)23- User asks to generate video (Veo, Wan, Seedance, OmniHuman)24- User asks about inference.sh or infsh25- User wants to run AI apps without managing individual provider APIs26- User asks for AI-powered search (Tavily, Exa)27- User needs avatar/lipsync generation28 29## Prerequisites30 31The `infsh` CLI must be installed and authenticated. Check with:32 33```bash34infsh me35```36 37If not installed:38 39```bash40curl -fsSL https://cli.inference.sh | sh41infsh login42```43 44See `references/authentication.md` for full setup details.45 46## Workflow47 48### 1. Always Search First49 50Never guess app names — always search to find the correct app ID:51 52```bash53infsh app list --search flux54infsh app list --search video55infsh app list --search image56```57 58### 2. Run an App59 60Use the exact app ID from the search results. Always use `--json` for machine-readable output:61 62```bash63infsh app run <app-id> --input '{"prompt": "your prompt here"}' --json64```65 66### 3. Parse the Output67 68The JSON output contains URLs to generated media. Present these to the user with `MEDIA:<url>` for inline display.69 70## Common Commands71 72### Image Generation73 74```bash75# Search for image apps76infsh app list --search image77 78# FLUX Dev with LoRA79infsh app run falai/flux-dev-lora --input '{"prompt": "sunset over mountains", "num_images": 1}' --json80 81# Gemini image generation82infsh app run google/gemini-2-5-flash-image --input '{"prompt": "futuristic city", "num_images": 1}' --json83 84# Seedream (ByteDance)85infsh app run bytedance/seedream-5-lite --input '{"prompt": "nature scene"}' --json86 87# Grok Imagine (xAI)88infsh app run xai/grok-imagine-image --input '{"prompt": "abstract art"}' --json89```90 91### Video Generation92 93```bash94# Search for video apps95infsh app list --search video96 97# Veo 3.1 (Google)98infsh app run google/veo-3-1-fast --input '{"prompt": "drone shot of coastline"}' --json99 100# Seedance (ByteDance)101infsh app run bytedance/seedance-1-5-pro --input '{"prompt": "dancing figure", "resolution": "1080p"}' --json102 103# Wan 2.5104infsh app run falai/wan-2-5 --input '{"prompt": "person walking through city"}' --json105```106 107### Local File Uploads108 109The CLI automatically uploads local files when you provide a path:110 111```bash112# Upscale a local image113infsh app run falai/topaz-image-upscaler --input '{"image": "/path/to/photo.jpg", "upscale_factor": 2}' --json114 115# Image-to-video from local file116infsh app run falai/wan-2-5-i2v --input '{"image": "/path/to/image.png", "prompt": "make it move"}' --json117 118# Avatar with audio119infsh app run bytedance/omnihuman-1-5 --input '{"audio": "/path/to/audio.mp3", "image": "/path/to/face.jpg"}' --json120```121 122### Search & Research123 124```bash125infsh app list --search search126infsh app run tavily/tavily-search --input '{"query": "latest AI news"}' --json127infsh app run exa/exa-search --input '{"query": "machine learning papers"}' --json128```129 130### Other Categories131 132```bash133# 3D generation134infsh app list --search 3d135 136# Audio / TTS137infsh app list --search tts138 139# Twitter/X automation140infsh app list --search twitter141```142 143## Pitfalls144 1451. **Never guess app IDs** — always run `infsh app list --search <term>` first. App IDs change and new apps are added frequently.1462. **Always use `--json`** — raw output is hard to parse. The `--json` flag gives structured output with URLs.1473. **Check authentication** — if commands fail with auth errors, run `infsh login` or verify `INFSH_API_KEY` is set.1484. **Long-running apps** — video generation can take 30-120 seconds. The terminal tool timeout should be sufficient, but warn the user it may take a moment.1495. **Input format** — the `--input` flag takes a JSON string. Make sure to properly escape quotes.150 151## Reference Docs152 153- `references/authentication.md` — Setup, login, API keys154- `references/app-discovery.md` — Searching and browsing the app catalog155- `references/running-apps.md` — Running apps, input formats, output handling156- `references/cli-reference.md` — Complete CLI command reference157