Skip to content

README.md

Latest commit

 

History

History
32 lines (26 loc) · 1.38 KB

README.md

File metadata and controls

32 lines (26 loc) · 1.38 KB
Raw

captcha-solver

A minimal, standalone Hermes plugin that solves CAPTCHAs via the CapSolver API. Just the simple solve path — create task → poll → return token. No proxy rotation, relay, or VNC.

This is also the first per-artifact private repo exercising the artifact-commons / trust-gate model: it lives private, can be collaborated on privately, and its visibility is flipped to public only when it's ready. The agent fleet references it as git:NimbleCoOrg/captcha-solver#<tag>; HSM fetches it at the pinned tag and runs the install-time injection-scan trust gate before installing.

Layout

  • hermes-plugin/ — the plugin (plugin.yaml, __init__.py registering the captcha_solve tool, capsolver.py the client).
  • hermes-skill/ — the captcha-solving skill teaching the agent when/how to use it.
  • tests/ — hermetic unit tests (HTTP injected; no network, no key).

Tool: captcha_solve

Args: type (e.g. ReCaptchaV2TaskProxyLess), website_url, website_key. Returns { "success": true, "solution": { ... } }. Requires CAPSOLVER_API_KEY.

Develop

python3 -m venv .venv && .venv/bin/pip install pytest
.venv/bin/python -m pytest tests/ -q

Capabilities

Declares declared_capabilities: { tools: [], network: true } — dispatches no other tools, calls the CapSolver API. Enforced by the runtime + install-time gate.