Getting Started
Kaabalah is a comprehensive TypeScript library for esoteric calculations — numerology, astrology, kabbalah, gematria, tarot, Ifa, and more.
Installation
npm install kaabalahpnpm install kaabalahyarn add kaabalahModules
Each module is tree-shakable and can be imported independently:
| Import path | What it provides |
|---|---|
kaabalah/core | Tree of Life graph — spheres, paths, and cross-system correspondences |
kaabalah/numerology | Life path, challenges, cycles, personal year calculations |
kaabalah/astrology | Birth charts, synastry, transits, profections, firdaria, ACG (Swiss Ephemeris) |
kaabalah/gematria | Hebrew numerology for Latin text, reverse gematria |
kaabalah/tarot | 78-card deck, profiles, archetypes, correspondences, multi-deck images, spread engine |
kaabalah/ifa | Ifa divination — Odu numbers from a date |
kaabalah/semantic | Occult theme profiles for NLP, search, and content tagging |
kaabalah/visual | Tree of Life SVG generation |
Quick Example
import { createTree } from 'kaabalah/core';
const tree = createTree({ system: 'kaabalah', parts: ['westernAstrology', 'tarot'],});Practical next steps
- If the terminology feels foreign, start with Concepts and terminology.
- If you want copy-paste workflows, jump to Practical recipes.
- If you’re doing astrology in the browser, read WebAssembly Integration.
- For the full list of features, see Features.