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
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 nhatnguyet3.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.
- 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-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.
- 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 内容安全护栏。