Kaabalah

A comprehensive TypeScript library for numerology, astrology, kaabalah, gematria, tarot, and Ifa divination.

Documentation

Full API reference, guides, and examples: docs.kaabalah.com

Installation

npm install kaabalah

Node.js 18.18+ required.

Modules

All modules are tree-shakable and can be imported independently:

| Module | Import | Description | |--------|--------|-------------| | Core | kaabalah/core | Tree of Life graph with cross-system correspondences | | Numerology | kaabalah/numerology | Life path, cycles, challenges, personal year | | Astrology | kaabalah/astrology | Birth charts, synastry, composite, transits, solar returns, profections, firdaria, astrocartography, dignity, decans, dodecatemoria | | Gematria | kaabalah/gematria | Hebrew letter numerology | | Tarot | kaabalah/tarot | 78-card deck with profiles, archetypes, correspondences, multi-deck images, spread engine | | Ifa | kaabalah/ifa | Odu divination | | Semantic | kaabalah/semantic | Theme profiles, kaabalistic overlay correspondences, symbol metadata | | Visual | kaabalah/visual | Tree of Life SVG generation and layout data |

Quick Example

import { createTree, id, KaabalahTypes } from 'kaabalah/core';
import { getBirthChart } from 'kaabalah/astrology';
import { calculateKaabalisticLifePath } from 'kaabalah/numerology';
import { getTarotCorrespondenceProfile } from 'kaabalah/tarot';
import { generateTreeSvg } from 'kaabalah/visual';

const tree = createTree({ system: 'kaabalah', parts: ['westernAstrology', 'tarot'] });
const correspondences = tree.getCorrespondences(id(KaabalahTypes.SPHERE, 'Tiphareth'), { depth: 2 });

const chart = await getBirthChart({
  date: { year: 1990, month: 6, day: 15, hour: 14, minute: 30 },
  latitude: 48.856, longitude: 2.352,
});

const lifePath = calculateKaabalisticLifePath(new Date('1990-06-15'));
const magician = getTarotCorrespondenceProfile({ tarotCardName: 'The Magician' });
const svg = generateTreeSvg({ background: 'transparent', palette: 'monochrome' });

CLI

npx kaabalah help                    # list all commands
npx kaabalah help --json             # full schema introspection
npx kaabalah numerology 1990-01-15 --json --compact
npx kaabalah astrology 1990-01-15 14:30 --lat=40.71 --lon=-74 --json
npx kaabalah tree:node "tarotArkAnnu:The Magician" --depth=2 --json

27 commands covering all modules. See the CLI Reference for the full list.

Support

License

AGPL-3.0 — see LICENSE.

Acknowledgments

• Swiss Ephemeris for astronomical calculations
• Astro.com for ephemeris data