Give your Hermes agent every paid tool — with one key.

# 1. drop the plugin into your Hermes plugins directory
git clone https://github.com/poolside-ventures/faro-hermes-plugin \
  ~/.hermes/plugins/faro

# 2. install the runtime dependency
pip install httpx

# 3. enable + authenticate
hermes plugins enable faro
hermes config set FARO_API_KEY faro_...    # or: export FARO_API_KEY=...

# done — start Hermes; faro_search + faro_invoke are now in scope
hermes

# ~/.hermes/plugins/faro/__init__.py
from . import schemas, tools


def register(ctx):
    ctx.register_tool(
        name="faro_search",
        toolset="faro",
        schema=schemas.FARO_SEARCH,
        handler=tools.faro_search,
        requires_env=["FARO_API_KEY"],
        description="Search the Faro marketplace for AI tools by intent or keyword.",
        emoji="🔎",
    )
    ctx.register_tool(
        name="faro_invoke",
        toolset="faro",
        schema=schemas.FARO_INVOKE,
        handler=tools.faro_invoke,
        requires_env=["FARO_API_KEY"],
        description="Invoke a Faro marketplace tool by namespace + name.",
        emoji="🛠️",
    )

# or use the askfaro CLI directly from any Hermes shell tool
pip install askfaro-cli
faro auth login

faro search "generate a 6-second product video"
faro invoke <namespace>/<tool> --params '{...}'

# REST equivalent
curl -X POST "https://api.askfaro.com/invoke/<namespace>/<tool>" \
  -H "Authorization: Bearer $FARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"prompt": "..."}}'