"Millionaires study markets, billionaires study stars" - AI astrology companion with timing guidance, natal analysis, and cosmic calendar integration.
Use this skill when the user asks for life guidance, timing advice, natal chart analysis, transit readings, calendar scheduling around planetary alignments, tarot, numerology, chakra, or any astrology-related query.
| What | Path |
|---|---|
| Oracle env file | ~/.hermes/oracle/.env |
| Profiles registry | ~/.hermes/oracle/profiles.json |
| Per-user profile | ~/.hermes/oracle/profiles/<id>/profile.json |
| Per-user consent | ~/.hermes/oracle/profiles/<id>/consent.yaml |
| Browser star map | ~/.hermes/skills/oracle/astro-companion/ui/oracle_chart.html |
On Oracle entry:
~/.hermes/oracle/profiles.jsonAll Astrovisor data is cached. natal-mcp is preferred for transits (local, free).
| Data Type | Location | TTL |
|---|---|---|
| Full natal data | profiles.json | Forever |
| Transits | profiles/<id>/cache/transits_YYYY-MM-DD.json | 1 hour |
| Solar returns | profiles.json | 1 year |
| Numerology | profiles.json | 1 year |
| Tarot | No cache (different each pull) | - |
# Transits use cache + natal-mcp
get_transits_with_cache(datetime, lat, lon, location, tz)
# Other data uses profiles.json cache
cached_data = profiles['profiles'][0]['cached_data']
Base URL: https://astrovisor.io
Token: from ~/.hermes/oracle/.env (ASTROVISOR_TOKEN)
| Endpoint | Purpose |
|---|---|
POST /api/natal/chart | Full natal chart (planets, houses, aspects, analysis) |
POST /api/natal/aspects | Major aspects between planets |
POST /api/minor-aspects/calculate | Minor aspects (quintile, septile, etc.) |
POST /api/harmonics/calculate | Harmonic charts reveal hidden patterns |
| Endpoint | Purpose |
|---|---|
POST /api/solar/return | Solar return for a year |
POST /api/solar/all-planetary-returns | Saturn, Jupiter, etc returns |
POST /api/solar/profections | Annual house profections |
POST /api/solar/lunations-overlay | New/Full Moons mapped to SR houses |
POST /api/calendar/generate | Daily predictions (background job) |
| Endpoint | Purpose |
|---|---|
POST /api/transits/calculate | Current transits to natal chart |
| Endpoint | Purpose |
|---|---|
POST /api/numerology/calculate | Life path, personal year, Pythagorean square |
POST /api/medical/chakra-analysis | 7-chakra energetic profile |
| Endpoint | Purpose |
|---|---|
GET /api/tarot/divination/daily | Card of the day |
GET /api/tarot/divination/single | Random single card |
POST /api/tarot/divination/spread | Multi-card spread |
{
"name": "Shane",
"datetime": "1991-08-21T16:20:00-04:00",
"latitude": 41.4489,
"longitude": -82.708,
"location": "Sandusky, Ohio, USA",
"timezone": "America/New_York",
"house_system": "P"
}
Oracle Star Map: file:///Users/sc/.hermes/skills/oracle/astro-companion/ui/oracle_chart.html
If Astrovisor rate-limits (429), use natal-mcp MCP server if configured.
natal-mcp provides: create_natal_chart, create_transit_chart, create_solar_return_chart
When user asks for Tarot, clarify:
| Script | Purpose |
|---|---|
| oracle_utils.py | API helpers, menu, cache helpers |
| oracle_astrology.py | Astrovisor calls |
| oracle_digest.py | Daily/weekly briefs |
| oracle_render.py | Terminal charts |
| oracle_launcher.py | Entry flow |
Full docs: see references/ directory