mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-11-17 04:11:35 +00:00
Two Windows agent-loop friction fixes: 1. tools/mcp_tool.py (#56536): shutil.which(cmd, path=env_path) reads executable extensions from the PARENT process PATHEXT, not the MCP subprocess env — a stdio MCP config supplying both PATH and PATHEXT could fail to resolve a command its own env can locate, and startup then got a bare command name. On Windows, when the first which() call misses and the config env carries PATHEXT (any key casing), retry the resolution with the config's PATHEXT temporarily applied. 2. skills/ + optional-skills/ (#50606): 42 SKILL.md files that declare platforms: [.., windows] used python3 in their command examples. python3 does not exist on native Windows (the toolchain probe in the system prompt reports python3=missing), so every copy-pasted example burned a failed agent turn before self-correction. Replaced the command word python3 -> python (python3-config / python3.x version strings untouched). python is the spelling that exists in every Hermes-managed environment (Windows native, uv-managed venvs on all three OSes); agents on POSIX hosts additionally see the probed toolchain line and adapt either way.
95 lines
2.7 KiB
Markdown
95 lines
2.7 KiB
Markdown
---
|
|
name: stocks
|
|
description: Stock quotes, history, search, compare, crypto via Yahoo.
|
|
version: 0.1.0
|
|
author: Mibay (Mibayy), Hermes Agent
|
|
license: MIT
|
|
platforms: [linux, macos, windows]
|
|
metadata:
|
|
hermes:
|
|
tags: [Stocks, Finance, Market, Crypto, Investing]
|
|
category: finance
|
|
related_skills: [dcf-model, comps-analysis, lbo-model]
|
|
---
|
|
|
|
# Stocks Skill
|
|
|
|
Read-only market data via Yahoo Finance. Five commands: `quote`, `search`,
|
|
`history`, `compare`, `crypto`. Python stdlib only — no API key, no pip
|
|
installs. Yahoo's endpoint is unofficial and may rate-limit or change.
|
|
|
|
## When to Use
|
|
|
|
- User asks for a current stock price (AAPL, TSLA, MSFT, ...)
|
|
- User wants to look up a ticker by company name
|
|
- User wants OHLCV history or performance over a date range
|
|
- User wants to compare several tickers side by side
|
|
- User asks for a crypto price (BTC, ETH, SOL, ...)
|
|
|
|
## Prerequisites
|
|
|
|
Python 3.8+ stdlib only. Optional: set `ALPHA_VANTAGE_KEY` to enrich
|
|
`market_cap`, `pe_ratio`, and 52-week levels when Yahoo's crumb-protected
|
|
fields come back null. Free key: https://www.alphavantage.co/support/#api-key
|
|
|
|
## How to Run
|
|
|
|
Invoke through the `terminal` tool. Once installed:
|
|
|
|
```
|
|
SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py
|
|
python $SCRIPT quote AAPL
|
|
```
|
|
|
|
All output is JSON on stdout — pipe through `jq` if you want to slice it.
|
|
|
|
## Quick Reference
|
|
|
|
```
|
|
python $SCRIPT quote AAPL
|
|
python $SCRIPT quote AAPL MSFT GOOGL TSLA
|
|
python $SCRIPT search "Tesla"
|
|
python $SCRIPT history NVDA --range 6mo
|
|
python $SCRIPT compare AAPL MSFT GOOGL
|
|
python $SCRIPT crypto BTC ETH SOL
|
|
```
|
|
|
|
## Commands
|
|
|
|
### `quote SYMBOL [SYMBOL2 ...]`
|
|
|
|
Current price, change, change%, volume, 52-week high/low.
|
|
|
|
### `search QUERY`
|
|
|
|
Find tickers by company name. Returns top 5: symbol, name, exchange, type.
|
|
|
|
### `history SYMBOL [--range RANGE]`
|
|
|
|
Daily OHLCV plus stats (min, max, avg, total return %). Ranges: `1mo`,
|
|
`3mo`, `6mo`, `1y`, `5y`. Default: `1mo`.
|
|
|
|
### `compare SYMBOL1 SYMBOL2 [...]`
|
|
|
|
Side-by-side: price, change%, 52-week performance.
|
|
|
|
### `crypto SYMBOL [SYMBOL2 ...]`
|
|
|
|
Crypto prices. Pass `BTC` (the script appends `-USD` automatically).
|
|
|
|
## Pitfalls
|
|
|
|
- Yahoo Finance's API is unofficial. Endpoints can change or rate-limit
|
|
without notice — if requests start failing, that's why.
|
|
- `market_cap` and `pe_ratio` may return null on `quote` when Yahoo's
|
|
crumb session isn't established. Set `ALPHA_VANTAGE_KEY` to backfill.
|
|
- Add a small delay between bulk requests to avoid rate-limiting.
|
|
- This is read-only — no order placement, no account integration.
|
|
|
|
## Verification
|
|
|
|
```
|
|
python ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL
|
|
```
|
|
|
|
Returns a JSON object with `symbol: "AAPL"` and a numeric `price` field.
|