ForkFree

Fun and creative

ziwei-doushu

by Renhuai123

An open-source chart-calculation engine for Zi Wei Dou Shu, a Chinese astrology system, based on Ni Haixia's Tianji teachings. It includes the calculation code, a pattern knowledge base, classical text data and a large downloadable dataset of pre-written chart readings.

Proof level: ReadWorth a lookMIT

Get it on GitHubProject websiteCompare

No demo yet

Proof level: Read. We read its README and licence and ran our automatic checks. We have not run it yet. So this page is based on its README and our automatic checks.

The catch

Worth a lookEstablished, with a few things to check (listed below).

Check this first: Documentation is in Chinese, with only a short English README.

Things to check

  • Documentation is in Chinese, with only a short English README
  • Interpretation database is not open source; only the engine and the generated dataset are
  • Dataset is very large (56.6 GB unpacked) and Ni Haixia's quoted words are non-commercial (CC BY-NC-SA 4.0)
  • Fortune-telling output has no scientific basis, and the README itself notes weaknesses in some readings
  • The demo interface is not the same as the hosted website

Can you use ziwei-doushu commercially?

Free to use, change and sell, including in paid products. Keep the copyright notice.

Not legal advice. Read the project's licence file before building a product on it.

What can you do with ziwei-doushu?

  • Calculate Zi Wei Dou Shu birth charts from a date, time and gender, with true solar time correction
  • Build your own astrology website or app on the TypeScript engine and its four-transformation and pattern data
  • Download the v4.0 readings dataset of about 675,000 charts for text analysis or content projects

How do you get ziwei-doushu running?

Clone the repository and run it as a Node.js/Next.js project with npm; the readings dataset is a separate large download from GitHub Releases.

Follow the official instructions in the project README.

Make money with it

Someone could offer paid chart-reading consultations or a niche astrology web app for Chinese-speaking audiences, using the engine to produce charts quickly.

An idea, not financial advice. Check the licence before charging for anything built on it.

Ways a business could use it

  • Add a birth-chart calculator to a website serving Chinese-speaking customers, using the MIT-licensed engine instead of paying for a licensed one
  • Use the pre-generated readings dataset as source material for fortune-telling content or consultation services

Who's talking about it

Checked 10 Nov 2026. Summary drafted by AI from the project's README. Proof level 1 of 4, Read: we read its readme and licence and ran our automatic checks. we have not run it yet.

Similar tools in Fun and creative

nxnative seedds
New and promising

nxnative is a tool that allows you to run Nintendo Switch games natively on iPhone and iPad by converting NSP files into unsigned IPAs.

Instead of LibHac, Ryujinx

Proof level: Read 16.3k stars +420 a day MIT
horizon horizon-rust
New and promising

Horizon is a free, unofficial rewrite of Minecraft: Java Edition 26.3 in Rust that runs as a native program without Java. It lets you play your existing worlds, join servers, use mods and shader packs, and host your own server, provided you own the game.

Proof level: Read 10.5k stars +385 a day MIT
pixelfx patch-gg
New and promising

A library of 244 pixel art effects and animations, such as fire, explosions, magic, weather and interface flourishes, each written as a small piece of JavaScript code. You can drop them into a browser game or export them as sprite sheets for other game engines.

Proof level: Read 8.4k stars +294 a day MIT