The Seer: a personal AI astrology oracle
A web app that calculates precise natal charts from actual planetary positions using Swiss Ephemeris, then delivers personalized oracle readings powered by OpenAI. Not generic horoscopes. Real charts, real transits, real AI.
- Type
- Personal project
- Stack
- Claude Code + React
- AI
- OpenAI GPT-4o-mini
- Status
- Live at theseer.xyz
Why I Built This
I noticed that every astrology related apps tend to go general. As someone very interested in the topic, I wanted to create something more "personal", and it has to use real astronomical data. So I designed the full experience; the oracle tone, the multi-profile system, the bilingual support, the daily ritual loop, and built it using Claude Code as my implementation partner. 109 commits, now live on theseer.xyz.
The app
Oracle
Cosmos
Bonds
Design Decisions
01
Precise, real data
The app runs Swiss Ephemeris calculations client-side via WebAssembly. Every chart reflects actual planetary positions at the user's birth moment. The AI receives this real data as context, so readings reference the user's actual astrological placements.
02
The oracle tone
Readings are capped at 4 sentences and written in a cryptic voice. The UI uses procedural audio (Web Audio API, not mp3 files) to create atmosphere. The goal was to have the feel of an authentic, mystical, yet reliable experience.
03
Multi-profile for relationship synastry
Users can store up to 10 profiles and run compatibility analysis between any two. The Bonds feature calculates synastry by comparing two full charts and assigning relationship tiers. This turned it from a solo novelty into something shareable.
04
PWA with bilingual support (English + Japanese)
Installable as a home screen app with offline capability. Full i18n for English and Japanese, including chart labels and reading outputs.