Introduction

A comprehensive TypeScript library for numerology, astrology, kaabalah, and tarot

The de-facto library for esoteric calculations and tooling

npm

npm install kaabalah

pnpm

yarn

Modules

🔢 Numerology

Life path, cycles, challenges, and personal mythology calculations

✡️ Gematria

Hebrew letter values with reverse gematria lookup

🌟 Astrology

Birth charts and planetary positions via Swiss Ephemeris

🃏 Tarot

78 cards with meanings, spreads, and interpretations

🐚 Ifa

Odu calculations based on dates for Ifa divination

🌳 Core

Tree of Life system linking all esoteric correspondences

Quick Start

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

example.ts

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);

Features

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';

TypeScript First

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

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

Learn More

📚 Documentation

Complete guides and tutorials for all modules

🔧 WebAssembly

Swiss Ephemeris WASM integration guide

📖 API Reference

Detailed API documentation for all exports

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

---