golbin

golbin / ssaju

Public

🐶작고 ⚡빠른 사주/만세력 라이브러리

46
11
100% credibility
Found Mar 05, 2026 at 46 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A compact JavaScript library that computes detailed Korean Saju (four pillars of destiny) charts, including elemental analysis, luck cycles, relationships, and interpretations from birth details.

How It Works

1
🔍 Discover ssaju

You hear about ssaju from a friend, a super quick tool that reveals your life path and luck cycles just from your birthday.

2
📅 Enter your birthday

You type in your birth year, month, day, time if known, and whether you're male or female – it's as simple as filling out a birthday card.

3
⚙️ Add extra details

Optionally pick if it's lunar calendar or your location for more precise timing, but it works great with basics too.

4
✨ Get your full chart

With one go, it calculates everything: your core energies, relationships, yearly and monthly luck flows, and helpful stars.

5
📊 View results your way

See a beautiful table perfect for reading yourself, or a short summary ready to chat about with an AI advisor.

🌟 Unlock life insights

You now have a clear map of your strengths, future cycles, and tips to make the most of your journey – feels empowering!

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 46 to 46 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is ssaju?

Ssaju is a tiny TypeScript library for computing Korean ssaju (four pillars of destiny) and manselok almanac data from a birth date. Drop in a year, month, day, hour, gender, and optional timezone or lunar details via `calculateSaju()`, and it spits out the full chart: original pillars, ten gods, 12 stages, element balances, relations (clashes, harms), luck cycles (daeun, seyun, wolun), voids, and gods. Get LLM-optimized compact text (~950 tokens) or polished Markdown tables for UIs.

Why is it gaining traction?

At 15KB gzipped with zero dependencies, it crushes perf at 0.04ms per calc (24k/sec), using astronomical approximations for accuracy without bloat. Dual outputs make it dead simple for LLM prompts or web displays, plus bonus lunar/solar converters. In a niche with clunky PHP ports or heavy frameworks, its speed and bundle-friendliness hook JS devs fast.

Who should use this?

Backend devs building Korean astrology APIs or apps needing quick ssaju lookups. Frontend folks embedding fortune charts in React/Vue sites. LLM wrappers piping birth data to GPT for interpretations, or timezone-aware tools handling local mean time for precise pillar calcs.

Verdict

Grab it if you need lightweight ssaju in TypeScript—solid API, benchmarks, and samples in README make prototyping instant. With 46 stars and 1.0% credibility, it's early-stage (watch for edge-case tests), but zero-fluff execution beats most alternatives today.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.