mirrors/hermes-agent
1
0
Fork 0
mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-04-25 00:51:20 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
hermes-agent/skills/inference-sh/cli/references/cli-reference.md
Teknium 6020db0243
feat: add inference.sh integration (infsh tool + skill) (#1682) 
Add inference.sh CLI (infsh) as a tool integration, giving agents
access to 150+ AI apps through a single CLI — image gen (FLUX, Reve,
Seedream), video (Veo, Wan, Seedance), LLMs, search (Tavily, Exa),
3D, avatar/lipsync, and more. One API key manages all services.

Tools:
- infsh: run any infsh CLI command (app list, app run, etc.)
- infsh_install: install the CLI if not present

Registered as an 'inference' toolset (opt-in, not in core tools).
Includes comprehensive skill docs with examples for all app categories.

Changes from original PR:
- NOT added to _HERMES_CORE_TOOLS (available via --toolsets inference)
- Added 12 tests covering tool registration, command execution,
  error handling, timeout, JSON parsing, and install flow

Inspired by PR #1021 by @okaris.

Co-authored-by: okaris <okaris@users.noreply.github.com>
2026-03-17 02:59:21 -07:00

3.1 KiB
Raw Blame History

CLI Reference

Installation

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

Global Commands

Command Description
infsh help Show help
infsh version Show CLI version
infsh update Update CLI to latest
infsh login Authenticate
infsh me Show current user

App Commands

Discovery

Command Description
infsh app list List available apps
infsh app list --category <cat> Filter by category (image, video, audio, text, other)
infsh app search <query> Search apps
infsh app list --search <query> Search apps (flag form)
infsh app list --featured Show featured apps
infsh app list --new Sort by newest
infsh app list --page <n> Pagination
infsh app list -l Detailed table view
infsh app list --save <file> Save to JSON file
infsh app my List your deployed apps
infsh app get <app> Get app details
infsh app get <app> --json Get app details as JSON

Execution

Command Description
infsh app run <app> --input <file> Run app with input file
infsh app run <app> --input '<json>' Run with inline JSON
infsh app run <app> --input <file> --no-wait Run without waiting for completion
infsh app sample <app> Show sample input
infsh app sample <app> --save <file> Save sample to file

Task Commands

Command Description
infsh task get <task-id> Get task status and result
infsh task get <task-id> --json Get task as JSON
infsh task get <task-id> --save <file> Save task result to file

Development

Command Description
infsh app init Create new app (interactive)
infsh app init <name> Create new app with name
infsh app test --input <file> Test app locally
infsh app deploy Deploy app
infsh app deploy --dry-run Validate without deploying
infsh app pull <id> Pull app source
infsh app pull --all Pull all your apps

Environment Variables

Variable Description
INFSH_API_KEY API key (overrides config)

Shell Completions

# Bash
infsh completion bash > /etc/bash_completion.d/infsh

# Zsh
infsh completion zsh > "${fpath[1]}/_infsh"

# Fish
infsh completion fish > ~/.config/fish/completions/infsh.fish

App Name Format

Apps use the format namespace/app-name:

  • falai/flux-dev-lora - fal.ai's FLUX 2 Dev
  • google/veo-3 - Google's Veo 3
  • infsh/sdxl - inference.sh's SDXL
  • bytedance/seedance-1-5-pro - ByteDance's Seedance
  • xai/grok-imagine-image - xAI's Grok

Version pinning: namespace/app-name@version

Documentation