Skip to content

aiskillstore/marketplace / skills/101-skills/infsh-cli

infsh-cli

Flagged

Run AI apps via inference.sh CLI - image generation, video creation, LLMs, search, 3D, Twitter automation. Models: FLUX, Veo, Gemini, Grok, Claude, Seedance, OmniHuman, Tavily, Exa, OpenRouter, and many more. Use when running AI apps, generating images/videos, calling LLMs, web search, or automating Twitter. Triggers: inference.sh, infsh, ai model, run ai, serverless ai, ai api, flux, veo, claude api, image generation, video generation, openrouter, tavily, exa search, twitter api, grok

FileKindSize
SKILL.mdskill md6.0 KB
references/app-discovery.mdmarkdown2.2 KB
references/authentication.mdmarkdown1.1 KB
references/cli-reference.mdmarkdown3.3 KB
references/running-apps.mdmarkdown3.6 KB
skill-report.jsonconfig58.6 KB

references/running-apps.md

View on GitHub
# Running Apps

## Basic Run

```bash
belt app run user/app-name --input input.json
```

## Inline JSON

```bash
belt app run falai/flux-dev-lora --input '{"prompt": "a sunset over mountains"}'
```

## Version Pinning

```bash
belt app run user/app-name@1.0.0 --input input.json
```

## Local File Uploads

The CLI automatically uploads local files when you provide a file path instead of a URL. Any field that accepts a URL also accepts a local path:

```bash
# 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"}'
```

Supported paths:
- Absolute paths: `/home/user/images/photo.jpg`
- Relative paths: `./image.png`, `../data/video.mp4`
- Home directory: `~/Pictures/photo.jpg`

## Generate Sample Input

Before running, generate a sample input file:

```bash
belt app sample falai/flux-dev-lora
```

Save to file:

```bash
belt app sample falai/flux-dev-lora --save input.json
```

Then edit `input.json` and run:

```bash
belt app run falai/flux-dev-lora --input input.json
```

## Workflow Example

### Image Generation with FLUX

```bash
# 1. Get app details
belt app get falai/flux-dev-lora

# 2. Generate sample input
belt app sample falai/flux-dev-lora --save input.json

# 3. Edit input.json
# {
#   "prompt": "a cat astronaut floating in space",
#   "num_images": 1,
#   "image_size": "landscape_16_9"
# }

# 4. Run
belt app run falai/flux-dev-lora --input input.json
```

### Video Generation with Veo

```bash
# 1. Generate sample
belt app sample google/veo-3-1-fast --save input.json

# 2. Edit prompt
# {
#   "prompt": "A drone shot flying over a forest at sunset"
# }

# 3. Run
belt app run google/veo-3-1-fast --input input.json
```

### Text-to-Speech

```bash
# Quick inline run
belt app run infsh/kokoro-tts --input '{"text": "Hello, this is a test."}'
```

## Task Tracking

When you run an app, the CLI shows the task ID:

```
Running falai/flux-dev-lora
Task ID: abc123def456
```

For long-running tasks, you can check status anytime:

```bash
# Check task status
belt task get abc123def456

# Get result as JSON
belt task get abc123def456 --json

# Save result to file
belt task get abc123def456 --save result.json
```

### Run Without Waiting

For very long tasks, run in background:

```bash
# Submit and return immediately
belt app run google/veo-3 --input input.json --no-wait

# Check later
belt task get <task-id>
```

## Output

The CLI returns the app output directly. For file outputs (images, videos, audio), you'll receive URLs to download.

Example output:

```json
{
  "images": [
    {
      "url": "https://cloud.inference.sh/...",
      "content_type": "image/png"
    }
  ]
}
```

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| "invalid input" | Schema mismatch | Check `belt app get` for required fields |
| "app not found" | Wrong app name | Check `belt app store search` |
| "quota exceeded" | Out of credits | Check account balance |

## Documentation

- [Running Apps](https://inference.sh/docs/apps/running) - Complete running apps guide
- [Streaming Results](https://inference.sh/docs/api/sdk/streaming) - Real-time progress updates
- [Setup Parameters](https://inference.sh/docs/apps/setup-parameters) - Configuring app inputs
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall