Don't have an agent yet?
Start here.

Install Hermes

Use the official installer for your OS. Desktop is easiest on Mac/Windows; CLI is fine on Linux/VPS.

Docs: hermes-agent.nousresearch.com/docs

# Linux / macOS / WSL — confirm current command on their site
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# Then open a new terminal and check
hermes --helpCopy

You should see Hermes CLI help — not “command not found.”

Connect a model (brain)

Hermes needs an LLM. Pick one:

• Cheapest / private: Ollama local (see Local section)
• Cheap API: OpenRouter or DeepSeek (OpenAI-compatible base URL + key)
• Strong hosted: Anthropic / OpenAI / Nous Portal / etc.

# Example: guided setup (flags may vary — use hermes setup --help)
hermes setup

# Or set provider env vars in ~/.hermes/.env as their docs describeCopy

Add Agent Media Tools as MCP

Option A — download our Hermes pack and follow the README inside:

⬇ agent-media-tools-hermes.tar.gz

Option B — point Hermes MCP config at a local clone or hosted URL. Typical pattern (paths vary by install):

# In Hermes MCP / config (YAML-style example)
mcp_servers:
  media-tool:
    command: "node"
    args: ["/absolute/path/to/mcp-server.js"]
    env:
      MEDIA_TOOL_URL: "https://agentmediatools.com"
      # optional for paid/agent endpoints:
      # MEDIA_TOOL_AGENT_KEY: "mt_your_key_here"Copy

In Hermes tool list / MCP UI you should see Agent Media Tools functions after reload.

More: Agent Hub · AI agents guide

Smoke test

In chat with Hermes:

• “Use Agent Media Tools to create a paste with the text: hello hermes”
• “Screenshot https://example.com and describe what you see” (free daily quota applies)

Install Claude Desktop

Download from claude.ai/download, sign in, finish any onboarding Anthropic requires.

Install our MCP extension (1 click)

⬇ Download agent-media-tools.mcpb

Double-click the file (or open it with Claude Desktop). Approve install when prompted. Fully quit and reopen Claude if tools don’t show.

Exact Settings UI labels change — look for MCP / Extensions / Connectors.

Deep dive: Claude MCP setup (5 min)

Fallback: custom instructions (no MCP install)

If you can’t install extensions, paste our instructions instead:

→ Claude custom instructions guide (copy-paste block)

Optional API key for premium / credits

Free tools work without a key. For image gen, higher limits, or agent-only routes: create a free account on agentmediatools.com → Account → API Keys → create key → put it where Claude/MCP env expects MEDIA_TOOL_AGENT_KEY if your pack supports it.

Install Ollama + pull a model

Install from ollama.com, then pull a model that supports tool use when possible:

# Example — model names change; check ollama.com/library
ollama pull llama3.2
ollama run llama3.2Copy

Choose how you chat / act

• Agent mode: Point Hermes at Ollama’s OpenAI-compatible endpoint (usually http://127.0.0.1:11434/v1)
• Chat UI: Install Open WebUI, connect Ollama, then add our OpenAPI tools

Open WebUI walkthrough: Open WebUI integration

Wire Agent Media Tools

With Hermes: same MCP steps as Hermes §3. With Open WebUI: import https://agentmediatools.com/openapi.json (or a trimmed subset) as tools/actions.

Create a Custom GPT

In ChatGPT (Plus/Team as required): Explore GPTs → Create → Configure. Name it e.g. “Media Tools Helper”.

Add Actions from OpenAPI

Import schema: https://agentmediatools.com/openapi.json

If the editor rejects a huge schema, import only the paths you need (paste, QR, resize, etc.) — see our guide.

Full guide: ChatGPT Custom GPT

Test in chat

“Create a short paste that says hello from ChatGPT using your action.”