01
What it is
An esoteric product is easy to build badly: ask a model to “describe this person from their birth date” and get beautiful text full of invented numbers. ORAKUL is built the other way round. Every number, arcana, planetary position and node is computed by a deterministic Python engine on the Skyfield astronomy library — the accuracy class used in scientific work. The LLM receives finished facts and only writes prose.
This is not pedantry for its own sake. It is what makes the product reproducible: the same inputs always produce the same reading, and the reading is cached.
Viewing it again is free, the model is not called twice, and users never watch the “oracle” change its mind about their character.
02
capabilities
What it does
01
Four computation engines
Destiny matrix, numerology, a Skyfield natal chart with the true lunar node, and a karmic engine. Each is covered by anchor tests.
02
A daily ritual
Tarot card, wheel, guess-the-colour, question of the day — four signs make a complete ritual. Retention is built on habit, not push spam.
03
Telegram Stars payments
A free hook, then paid tiers: portrait, compatibility, karma, year forecast. Idempotency on the payment charge id — the item is delivered exactly once.
04
Cached readings
A hash of the inputs maps to a finished reading. Re-viewing costs nothing and does not depend on API availability.
05
Privacy inside the prompt
No direct identifiers reach the model: only computed numbers and positions plus a first name for address. Full names are substituted locally.
06
Tone and limits
Every text passes through a “warm, non-categorical oracle” tone template. No medical, financial or legal claims, and no guarantees about the future.
03
architecture
How it works
01
Onboarding and consent
02
Deterministic computation
03
LLM text generation
04
Cache and Mini App render
05
Stars payment and tiers
Under the hood
- Fully isolated on a shared host: own containers, own ports, a separate nginx block — neighbouring projects untouched.
- aiogram 3 with an FSM onboarding flow; FastAPI as the API; React + Vite for the visual report.
- Telegram initData validated with HMAC-SHA256 on every Mini App request.
- Mandatory gates: 18+ and a dedicated personal-data consent screen — no consent, no computation.
- Every model call is cost-logged: model, tokens, dollars, plus an alert when the budget is exceeded.
- Astronomy on Skyfield (MIT licence) — no proprietary ephemerides.
04
scale
Numbers
4
computation engines
0
numbers computed by the model
24 h
initData validity window
Stars
payment rail