hermes-api-client
/hermes-api-client
Call a Hermes agent from Kilo Code via the local chat completions API. Use for web scraping, browser automation, and research tasks that Hermes handles better (saved credentials, browser tools, web search). Load with read_file on .kilocode/skills/hermes-api-client/SKILL.md (ignore the absolute path in the location tag).
- Author
- ScotterMonk ↗
- Repository
- AgentAutoFlow ↗
- Licence
- CC0-1.0
- Last repository change
- 22.06.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 5
No signals detected. Repository changed on 22.06.2026, without references to retired models or APIs.
CC0-1.0, otwarta.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/hermes_api.py
What it does and when to use it
Call a Hermes agent from Kilo Code via the local chat completions API. Use for web scraping, browser automation, and research tasks that Hermes handles better (saved credentials, browser tools, web search). Load with read_file on .kilocode/skills/hermes-api-client/SKILL.md (ignore the absolute path in the location tag).
Original author description
Call a Hermes agent from Kilo Code via the local chat completions API. Use for web scraping, browser automation, and research tasks that Hermes handles better (saved credentials, browser tools, web search). Load with read_file on .kilocode/skills/hermes-api-client/SKILL.md (ignore the absolute path in the location tag).
How it works
- Prerequisites
- The Tool Script
- Modes
- Quick Reference
- Error Handling
- Future Customization Points
- Tips
SKILL.md preview
---
name: hermes-api-client
description: >
Call a Hermes agent from Kilo Code via the local chat completions API.
Use for web scraping, browser automation, and research tasks that
Hermes handles better (saved credentials, browser tools, web search).
Load with read_file on .kilocode/skills/hermes-api-client/SKILL.md (ignore the absolute path in the location tag).
modes:
- name: scrape
description: Extract structured JSON data from a website
template: |
Navigate to {url}. {login clause}. Extract ONLY {fields} as a
clean JSON array. No extra text, no markdown. Just the JSON.
- name: research
description: Web research and synthesis
template: |
Research {topic}. Be thorough but concise. Use web search.
- name: browser
description: Full browser automation — login, navigate, act
template: |
Log into {site} as {email}. Navigate to {target}. {action}.
Return results as clean JSON. No extra text.
- name: extract
description: Pull specific named fields from a page
template: |
Go to {url} and extract ONLY these fields as JSON: {fields}.
No other text.
---
# Hermes API Client — Kilo Code Skill
Call a Hermes agent from Kilo Code. Hermes may have browser tools, web search, and saved site credentials that Kilo Code lacks. Delegate scraping/browsing/research tasks via a single Python function. Read skill-local guidance only when `.kilocode/skills/hermes-api-client/AGENTS.md` is confirmed to exist; otherwise use root `AGENTS.md` for project-specific gateway, host, credential, and site notes.
## Prerequisites
- Hermes gateway available and reachable
- Python 3 + `requests` installed (`pip install requests`)
## The Tool Script
Use `.kilocode/skills/hermes-api-client/scripts/hermes_api.py`. When importing it from a project-root script, add `.kilocode/skills/hermes-api-client/scripts` to `sys.path` or run a small wrapper from that directory.
## Modes
### Mode 1 — Scrape (structured data extraction)
```python
from hermes_api import query_hermes
import json
result = query_hermes(
"Navigate to https://example.com/events, find all upcoming "
"events, return ONLY a clean JSON array with fields: "
"title, date, venue. No extra text."
)
data = json.loads(result)
```
Or use the convenience wrapper:
```python
from hermes_api import scrape
meets = scrape(
"https://example.com/...",
fields="name,date,location",
site="example.com",
)
```
### Mode 2 — Research
```python
result = query_hermes(
"Research the current state of WebGPU in Electron. "
"Be thorough but concise."
)
# result is plain text / markdown
```
### Mode 3 — Browser Automation
```python
result = query_hermes(
"Log into amazon.com as user@email.com, navigate to order "
"history, return last 5 orders as JSON with fields: "
"item, price, status, date. No extra text."
)
```
### Mode 4 — Field Extraction
```python
result = query_hermes(
"Go to https://example.com/product/123 and extract ONLY "
"these fields as JSON: price, in_stock, sku. No other text."
)
```
## Quick Reference
**Get prices from X** — Use scrape mode with `scrape(url, fields, site=...)`.
**What's the best way to…** — Use research mode with `query_hermes("Research …")`.
**Log into X and download…** — Use browser mode with `query_hermes("Log into X …")`.
**Pull the author from…** — Use extract mode with `query_hermes("Extract fields: …")`.
## Error Handling
```python
try:
data = scrape("https://example.com/data", "name,price")
except requests.Timeout:
# Site slow, CAPTCHA, Cloudflare block
print("Hermes timed out — try longer timeout or simpler query")
except requests.HTTPError as e:
print(f"API error {e.response.status_code}: {e.response.text}")
except json.JSONDecodeError:
# Prompt likely missing "No extra text, just the JSON"
print(f"Hermes returned non-JSON. Add stricter prompt.")
```
## Future Customization Points
**1. Dedicated scraper agent** — If you create a Hermes profile just
for scraping, change `MODEL` in the script:
```python
# Before (default agent):
MODEL = "hermes-agent"
# After (dedicated scraper profile):
MODEL = "scraper"
```
**2. Different Hermes host** — If the gateway moves:
```python
API_URL = "http://other-host:8642/v1/chat/completions"
```
**3. Streaming responses** — For long tasks, switch to `stream: True`
and process chunks. See OpenAI streaming docs for pattern.
**4. Multiple agents** — If you have separate agents for separate sites:
```python
MODEL_MAP = {
"example.com": "example-scraper",
"shopping-site": "shopping-scraper",
"default": "hermes-agent",
}
def scrape(url, fields, site=None):
model = MODEL_MAP.get(site, MODEL_MAP["default"])
return query_hermes(prompt, model=model) # add model param
```
## Tips
1. **"No extra text, just the JSON"** — non-negotiable for parseable
output. Hermes agents are chatty otherwise.
2. **One task per call** — don't ask for two different sites in one
prompt. Split into separate `query_hermes()` calls.
3. **Be specific about fields** — `"name,date,location"` beats
`"give me all the details"`.
4. **Timeout wisely** — browser tasks: 120-300s. Simple API calls: 30s.
5. **Site credentials live in Hermes** — Kilo Code doesn't need them.
Hermes agents have saved logins for sites they're configured for.
Files in this package (3)
- AGENTS.md 1 KB
- SKILL.md 5 KB
- scripts/hermes_api.py 2 KB
Versions
The database has no other skills named hermes-api-client.
Database snapshot: 13.11.2026 · package version 59c7c909fa35 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 96hermes-agent-factory
Use when creating or cloning a Hermes agent profile. - 100kilo-code
Kilo Code is an open-source AI coding agent that runs in the terminal, VS Code and JetBrains, reads and edits a codebase, runs commands, and works with 500+ models from any provider, including local Ollama. Use it to script the `kilo` CLI: one-shot `kilo run` tasks, CI jobs with… - 100skill-creator
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch; evaluate, update or optimize an existing skill; run evals to test a skill; benchmark skill performance with variance analysis; or optimize a… - 86hermes-gateway-web-ui
Use when connecting a web UI to the Hermes gateway. - 86hermes-box-diagnosis
Use when hermes-agent loops or its memory is full. - 90hermes-extend
Use when extending Hermes Agent - writing or installing Hermes skills (SKILL.md format, ~/.hermes/skills, agent-created skills, skill_manage, curator, skills.write_approval), installing and managing plugins (catalog, plugins.enabled, auto-update, pinned refs), choosing a memory…