Skip to content
@Nhat-Nguyet

Nhat Nguyet

Open source East Asian calendars, Zi Wei, BaZi, I Ching and numerology, open data, and AI guardrails. The engine behind nhatnguyet.org.

Nhat Nguyet

Open source tools for East Asian calendars and traditional knowledge, and for safer AI.
The engine behind nhatnguyet.org: lunar calendars, Zi Wei Dou Shu, BaZi, the I Ching, numerology and feng shui, computed from astronomy and explained from the classics, in English, 中文 and Tiếng Việt.

Project page · Docs · Open data · Hugging Face · Contact

What we publish

Libraries for JavaScript and Python, plus an MCP server for AI assistants.

  • Lunar calendars of China, Korea, Japan, Vietnam and 7 more countries and regions, with new moons and solar terms checked against NASA and IMCCE from 1900 to 2100.
  • Zi Wei Dou Shu, BaZi, the I Ching, numerology and feng shui. Where the schools disagree, you choose the school instead of getting one silent default.
  • 17,291 shared test vectors, so JavaScript and Python give the same answer.
  • 14 MCP tools, so a model looks up a date or casts a chart instead of guessing.
npm i @nhatnguyet/ziwei @nhatnguyet/lunar   # or: pip install nhatnguyet

Open data

3.6 million charts with readings that cite the classics by book and chapter, and 33 datasets with DOIs, released under CC BY 4.0. They are on Hugging Face, Zenodo and du-lieu-am-lich.

AI safety

  • guardrail-chatbot-jev: content safety guardrails for AI chatbots. Input, output and whole-conversation checks run from one policy file, with a compliance pack for Vietnamese law.
  • guardrail-rag-jev: guardrails for RAG. It checks documents before indexing, user queries, retrieved passages and answers, and names the legal basis of every violation.

Product management

product-skill-jev: a product management co-pilot that writes the documents, keeps the process honest and leaves every decision to you.

14 free widgets that each go into a page with two lines of HTML: lunar calendar, today's date, auspicious hours, date converter, Tết countdown, Lỗ Ban ruler and more. No account or API key, in Vietnamese, English or Chinese.

How we work

  • Sources first. Calendar results are checked against astronomy. Readings quote the book and chapter they come from.
  • Schools stated. When traditions differ, we name each one and let you choose.
  • Same answer everywhere. The website, the app, the libraries and the datasets all run on one engine.

Code is MIT, data is CC BY 4.0. Issues, discussions and pull requests are welcome.


Tiếng Việt. Nhật Nguyệt là nền tảng tri thức và tra cứu về lịch pháp, Tử Vi, Bát Tự, Kinh Dịch, thần số học, phong thuỷ và văn hoá tâm linh Việt Nam. Mã nguồn, dữ liệu mở và rào chắn an toàn cho AI ở đây là chính bộ máy chạy nhatnguyet.org.
中文. Nhat Nguyet 提供东亚历法与传统术数的开源程序库和开放数据,并发布 AI 内容安全护栏。

Pinned Loading

  1. du-lieu-am-lich du-lieu-am-lich Public

    Dữ liệu lịch pháp và tra cứu văn hoá Việt Nam, CC BY 4.0. Vietnamese calendrical and cultural reference data.

    1

  2. nhatnguyet-lunar-ziwei-bazi-numerology nhatnguyet-lunar-ziwei-bazi-numerology Public

    Lunisolar calendar, Zi Wei Dou Shu, BaZi, numerology, I Ching and feng shui for JavaScript and Python: astronomically accurate (NASA, IMCCE), country-aware (China, Korea, Japan, Vietnam and 7 more)…

    TypeScript 10 6

  3. product-skill-jev product-skill-jev Public

    A product management co-pilot that writes the documents, keeps the process honest, and leaves every decision to you. Plain language in, plain markdown out.

    Python 1

  4. guardrail-chatbot-jev guardrail-chatbot-jev Public

    Content safety guardrails for AI chatbots: input, output and whole-conversation checks from one policy file, every violation named with its legal basis. Viet Nam compliance pack. Python, TypeScript…

    Python 1

  5. guardrail-rag-jev guardrail-rag-jev Public

    Content guardrails for RAG systems, with Jev as the decision model. Checks documents before indexing, user queries, retrieved passages and generated answers. Names every violation with its legal ba…

    Python 1

  6. nhatnguyet-widgets nhatnguyet-widgets Public

    14 free embeddable widgets: lunar calendar, auspicious hours, Tết countdown, date converter, Lỗ Ban ruler and more. Two lines of HTML, no account or API key. Vietnamese, English, Chinese.

    HTML

Repositories

Showing 10 of 21 repositories
  • nhatnguyet-lunar-ziwei-bazi-numerology Public

    Lunisolar calendar, Zi Wei Dou Shu, BaZi, numerology, I Ching and feng shui for JavaScript and Python: astronomically accurate (NASA, IMCCE), country-aware (China, Korea, Japan, Vietnam and 7 more), results in English, Chinese and Vietnamese. MCP server for AI, 17,291 shared test vectors, open datasets. 农历 紫微斗数 八字 易经 风水

    Nhat-Nguyet/nhatnguyet-lunar-ziwei-bazi-numerology's past year of commit activity
    TypeScript 10 MIT 6 12 (3 issues need help) 3 Updated Nov 20, 2026
  • product-skill-jev Public

    A product management co-pilot that writes the documents, keeps the process honest, and leaves every decision to you. Plain language in, plain markdown out.

    Nhat-Nguyet/product-skill-jev's past year of commit activity
    Python 1 0 0 0 Updated Nov 20, 2026
  • .github Public

    Organisation profile of Nhat Nguyet

    Nhat-Nguyet/.github's past year of commit activity
    0 0 0 0 Updated Nov 20, 2026
  • widget-xo-so Public archive

    Moved to Nhat-Nguyet/nhatnguyet-widgets

    Nhat-Nguyet/widget-xo-so's past year of commit activity
    HTML 1 0 0 0 Updated Nov 20, 2026
  • widget-tu-vi-12-con-giap Public archive

    Moved to Nhat-Nguyet/nhatnguyet-widgets

    Nhat-Nguyet/widget-tu-vi-12-con-giap's past year of commit activity
    HTML 0 0 0 0 Updated Nov 20, 2026
  • widget-tim-kiem Public archive

    Moved to Nhat-Nguyet/nhatnguyet-widgets

    Nhat-Nguyet/widget-tim-kiem's past year of commit activity
    HTML 0 0 0 0 Updated Nov 20, 2026
  • widget-thuat-ngu-hom-nay Public archive

    Moved to Nhat-Nguyet/nhatnguyet-widgets

    Nhat-Nguyet/widget-thuat-ngu-hom-nay's past year of commit activity
    HTML 0 0 0 0 Updated Nov 20, 2026
  • widget-ngay-tot Public archive

    Moved to Nhat-Nguyet/nhatnguyet-widgets

    Nhat-Nguyet/widget-ngay-tot's past year of commit activity
    HTML 0 0 0 0 Updated Nov 20, 2026
  • widget-lo-ban Public archive

    Moved to Nhat-Nguyet/nhatnguyet-widgets

    Nhat-Nguyet/widget-lo-ban's past year of commit activity
    HTML 0 0 0 0 Updated Nov 20, 2026
  • widget-lich-thang Public archive

    Moved to Nhat-Nguyet/nhatnguyet-widgets

    Nhat-Nguyet/widget-lich-thang's past year of commit activity
    HTML 0 0 0 0 Updated Nov 20, 2026

People

This organization has no public members. You must be a member to see who’s a part of this organization.