Hermes
Data Intelligence Platform
A foundational intelligence data platform for acquiring, validating, normalizing, storing, and serving country risk and financial intelligence datasets — one async Python API over 10+ source families.
Install
uv add hermes-pltcapabilities
What it does
10 Data Sources
World Bank, IMF, GDELT, OpenSanctions, FRED, Binance, Finnhub, SEC EDGAR, Yahoo Finance, and bundled datasets — all behind one async API.
58 Country Risk Features
Economic, geopolitical, security, social, and environmental indicators computed concurrently for any ISO3 country.
86-Field Technical Analysis
Crypto technical snapshots from Binance — price, volatility, order book, funding rates, composite scores.
71-Field Fundamental Analysis
Stock fundamentals from Finnhub, SEC EDGAR, FRED, and Yahoo Finance — income, balance sheet, valuation, macro context.
Parquet TTL Cache
Every fetch cached to disk with per-source TTLs. SHA-256 keying, hit/miss stats, and manual eviction.
Feature Lineage Graph
@feature decorator registers every function in a dependency graph with topological tier resolution.
sources
10 data sources, one API
quick start
Up and running in seconds
import asyncio
from hermes import Hermes
async def main():
hr = Hermes(
opensanction_api="your-key",
fred_api="your-key",
finnhub_api="your-key",
sec_username="you",
sec_email="you@example.com",
)
# Country risk snapshot
risk = await hr.country_features.get_country_risk_features("USA")
print(risk["economic"]["gdp_growth_yoy"])
# Technical snapshot
ta = await hr.ta_feature.get_technical("BTCUSDT")
print(ta.trend_score)
asyncio.run(main())stack