description	A comprehensive TypeScript library for numerology, astrology, kaabalah, and tarot
layout	width title description tableOfContents outline pagination metadata wide visible true visible true visible true visible visible true visible true
metaLinks	alternates https://app.gitbook.com/s/2AwfWOGBWBxQmyvHedqW/

Introduction

The de-facto library for esoteric calculations and tooling

{% tabs %} {% tab title="npm" %}

npm install kaabalah

{% endtab %}

{% tab title="pnpm" %}

pnpm install kaabalah

{% endtab %}

{% tab title="yarn" %}

yarn add kaabalah

{% endtab %} {% endtabs %}

Modules

🔢 Numerology	Life path, cycles, challenges, and personal mythology calculations	numerology.md
✡️ Gematria	Hebrew letter values with reverse gematria lookup	gematria.md
🌟 Astrology	Birth charts and planetary positions via Swiss Ephemeris	astrology.md
🃏 Tarot	78 cards with meanings, spreads, and interpretations	tarot.md
🐚 Ifa	Odu calculations based on dates for Ifa divination	ifa.md
🌳 Core	Tree of Life system linking all esoteric correspondences	core.md

Quick Start

{% columns %} {% column %}

Get started in 5 minutes

Setting up your first calculation is easy. With clear APIs, copy-paste-ready examples, and quick setup, you'll be up and running in minutes.

Get Started API Reference {% endcolumn %}

{% column %} {% code title="example.ts" overflow="wrap" %}

import { calculateGematria } from 'kaabalah/gematria';
import { calculateKaabalisticLifePath } from 'kaabalah/numerology';

// Calculate gematria for a name
const gematria = calculateGematria('DAVID');
console.log(gematria.synthesis.originalSum); // 25

// Calculate life path from birth date
const lifePath = calculateKaabalisticLifePath(new Date('1990-06-15'));
console.log(lifePath.lifePath.reducedValue);

{% endcode %} {% endcolumn %} {% endcolumns %}

Features

{% columns %} {% column %}

Tree-Shakable

Import only what you need. Each module is independently tree-shakable for optimal bundle size.

// Only imports gematria module
import { calculateGematria } from 'kaabalah/gematria';

{% endcolumn %}

{% column %}

TypeScript First

Full TypeScript support with comprehensive type definitions for all functions and return values.

import type { TarotCard, GematriaResult } from 'kaabalah';

{% endcolumn %} {% endcolumns %}

Learn More

📚 Documentation	Complete guides and tutorials for all modules	getting-started.md
🔧 WebAssembly	Swiss Ephemeris WASM integration guide	webassembly.md
📖 API Reference	Detailed API documentation for all exports	api.md

New to esoterism?

Start here:

• Concepts and terminology
• Practical recipes

Community

GitHub	100% open source. Star the repo, report issues, or submit PRs.	View on GitHub

---