Saju — Quatro Pilares do Destino Coreano
hoonsikim/saju
Saju autêntico, IA-potenciado, rodando client-side com resultados compartilháveis
Ver no GitHubPlugin de astrologia coreana autêntica (Saju) com motor de Quatro Pilares, compatibilidade e previsões diárias em 20 idiomas. Roda 100% no navegador, sem backend obrigatório, e gera resultados compartilháveis via URL. Usa metodologia equivalente ao Posteller, o app de fortuna #1 da Coreia.
Instalação
npx convez-ai hoonsikim/saju1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar leituras de Quatro Pilares com gráfico e análise de Cinco Elementos
- Calcular compatibilidade entre dois mapas astrais (0-100 com veredicto)
- Criar previsões diárias e ciclos de sorte de 10 anos (Daewoon)
- Compartilhar resultados de astrologia coreana em redes sociais
Veredito

Ferramenta niche e bem-executada para astrologia coreana legítima, com engine JavaScript robusto (testado contra padrão-ouro coreano) e UX moderna. Ideal para exploradores interessados em metodologias orientais autênticas; construtores podem reutilizar o motor standalone via Gist.
README
A tradução para o português deste README ainda está na fila.
saju
Korean Four Pillars of Destiny (사주, 四柱) — global edition.
Authentic Korean Saju methodology, AI-powered, in 20 languages. Not Western astrology pretending to be Eastern. Real Year/Month/Day/Hour pillars, Five Elements balance, Ten Gods, Daewoon (10-year luck cycles).
Try it
- Reading — https://hoonsikim.github.io/saju — Four Pillars chart + Five Elements + Ten Gods for any birth date/time
- Daily fortune — https://hoonsikim.github.io/saju/today.html — today's reading + 7-day forecast strip, surfaces the best day of the week
- Compatibility (궁합) — https://hoonsikim.github.io/saju/compat.html — two birth charts, a 0–100 verdict, shareable result card
All three run fully client-side. Enter a birth date/time, get a reading instantly. Every result is a shareable URL — open someone's link and their chart renders on your screen.
What it does
- 20 languages: English · 한국어 · 日本語 · 中文 · Español · Português · Français · Deutsch · Italiano · Русский · Türkçe · Nederlands · Polski · Svenska · Bahasa Indonesia · Filipino · Tiếng Việt · ไทย · हिन्दी · العربية
- Four Pillars engine: Year/Month/Day/Hour gan-ji, Five Elements ratio, Ten Gods auto-labeling — handles 立春 solar-term boundaries
- Compatibility: four-axis score (Day Master relation, Day Branch 六合/相沖, Five Elements complement, combined balance) → soulmate/strong/good/mixed/challenging verdict
- Shareable: URL-encoded birth state, native Web Share, downloadable verdict card (PNG)
- Pricing (planned): free basic reading → premium detailed reading / membership
Why this exists
Co-Star, The Pattern, Cafe Astrology — all Western astrology. The K-wave is global, but no modern Saju app exists outside Korea. ChatGPT can do it but with zero UX, no sharing, no consistency.
This fills that gap: authentic Korean Saju + modern UX + AI consistency + shareable results.
Accuracy
Matches Posteller (포스텔러 만세력 2.2) — Korea's #1 fortune app — 100% on the benchmark case (1990-12-20 16:30 KST → 庚午 / 戊子 / 己未 / 壬申). See test/saju.test.js.
Stack
Static frontend (GitHub Pages) + a Four Pillars engine in plain JS. Optional Cloudflare Worker calls the Claude API for narrative reading generation; without it the site falls back to a built-in rule-based reading, so it works with zero backend.
Standalone engine
The Four Pillars engine — birthInfoToFourPillars, Five Elements balance, Ten Gods — is also published as a standalone, single-dependency Gist you can drop into any project:
https://gist.github.com/hoonsikim/03a5faced1f270edbd4ca8d580f2edb5
Handles 立春 solar-term and 子時 day boundaries the way Korean 만세력 does — the part most JS bazi libraries get wrong.
License
MIT for code. Reading methodology = public-domain Korean tradition.