Ziwei Doushu – Bộ công cụ lập lá số Tử Vi Đẩu Số mã nguồn mở

Ziwei Doushu – Bộ công cụ lập lá số Tử Vi Đẩu Số mã nguồn mở - 1

Nếu bạn quan tâm đến huyền học phương Đông, đặc biệt là Tử Vi Đẩu Số, hoặc đang muốn xây dựng một ứng dụng luận giải tử vi kết hợp với AI, thì Ziwei Doushu là một dự án mã nguồn mở rất đáng để khám phá.

Không đơn thuần là một website xem tử vi, dự án cung cấp cả bộ máy tính toán lá số, hệ thống kiến thức cổ điển, thuật toán an sao và kho dữ liệu luận giải với hàng triệu nội dung. Lập trình viên có thể tận dụng những tài nguyên này để xây dựng ứng dụng riêng, trong khi người yêu thích tử vi có thêm một nguồn tài liệu để học tập và nghiên cứu.

Ziwei Doushu là gì?

Ziwei Doushu (紫微斗数 – Tử Vi Đẩu Số) là dự án mã nguồn mở được phát triển dựa trên hệ thống giảng dạy Thiên Kỷ (天纪) của Nghê Hải Hạ (倪海厦), với mục tiêu số hóa kiến thức tử vi truyền thống và giúp mọi người dễ dàng tiếp cận thông qua công nghệ hiện đại.

Dự án được xây dựng bằng Next.js 16, TypeScript, Tailwind CSS, Framer Motion, kết hợp với thư viện iztro và lunar-javascript để xử lý các thuật toán lập lá số.

Tính đến ngày 22/11/2026, dự án đã thu hút hơn 19.000 sao trên GitHub. Phần mã nguồn được phát hành theo giấy phép MIT, cho phép sử dụng, chỉnh sửa và phát triển thành sản phẩm riêng, kể cả sản phẩm thương mại.

Những tính năng nổi bật Ziwei Doushu

Lập lá số Tử Vi Đẩu Số tự động

Đây là tính năng cốt lõi của dự án. Chỉ cần cung cấp ngày tháng năm sinh, giờ sinh và giới tính, hệ thống có thể tự động xác định cung Mệnh, cung Thân, ngũ hành cục, an 14 chính tinh, các phụ tinh và thiết lập lá số 12 cung.

Người dùng có thể xem chi tiết từng cung, chuyển đổi giữa bản mệnh, đại hạn và lưu niên để tìm hiểu lá số theo từng giai đoạn khác nhau.

Toàn bộ quá trình tính toán được thực hiện trực tiếp trên trình duyệt, không cần máy chủ AI hay API Key.

Hỗ trợ nhiều phương pháp lập lá số

Một điểm khá thú vị của Ziwei Doushu là không cố định toàn bộ thuật toán theo duy nhất một trường phái. Dự án hỗ trợ hiệu chỉnh giờ mặt trời thực theo kinh độ nơi sinh, tùy chỉnh cách xử lý tháng nhuận, quy tắc chuyển ngày đối với giờ Tý và phương pháp xác định độ sáng của các sao.

Hệ thống cũng hỗ trợ Tứ Hóa gồm Hóa Lộc, Hóa Quyền, Hóa Khoa và Hóa Kỵ, kết hợp với phi tinh, tự hóa và các quy tắc nhận diện cách cục truyền thống như Tử Phủ Đồng Cung, Nhật Nguyệt Tịnh Minh hay Thất Sát Triều Đẩu.

Điều này đặc biệt hữu ích nếu bạn muốn nghiên cứu sự khác biệt giữa các phương pháp lập lá số hoặc phát triển một ứng dụng tử vi có khả năng tùy chỉnh chuyên sâu.

Kho dữ liệu hơn 8,7 triệu nội dung luận giải

Điểm ấn tượng nhất của Ziwei Doushu có lẽ nằm ở bộ dữ liệu mà tác giả công khai cho cộng đồng.

Phiên bản Dataset v4.0, phát hành ngày 15/10/2026, sở hữu quy mô khá lớn:

Số lượng lá số
674.976
Đoạn luận giải
8.774.688
Dung lượng giải nén
56,6 GB
Phạm vi năm sinh
1950–2026

Mỗi lá số được luận giải theo 13 chủ đề khác nhau, bao gồm tổng quan bản mệnh, tài vận, sự nghiệp, tình cảm, gia đình và sức khỏe theo quan niệm tử vi truyền thống.

Đây là nguồn dữ liệu đáng chú ý dành cho những ai muốn xây dựng hệ thống RAG, tinh chỉnh mô hình ngôn ngữ, phát triển chatbot huyền học hoặc nghiên cứu dữ liệu có cấu trúc.

Tuy nhiên, cần hiểu rằng đây là dữ liệu được tạo từ hệ thống thuật toán và luận giải của dự án, không phải hồ sơ thực tế của hàng trăm nghìn người hay dữ liệu đã được kiểm chứng về khả năng dự đoán tương lai.

Thư viện kiến thức và cổ thư tử vi

Ngoài thuật toán lập lá số, dự án còn tích hợp nội dung từ nhiều tài liệu cổ điển như Cốt Tủy Phú, Tử Vi Đẩu Số Toàn Thư và Tử Vi Đẩu Số Toàn Tập.

Kho kiến thức được tổ chức thành các dữ liệu có cấu trúc, bao gồm 14 chính tinh kết hợp với 12 cung, hệ thống nhận diện cách cục và phương pháp đối chiếu hai lá số.

Người dùng có thể tra cứu nội dung cổ thư, tìm hiểu ý nghĩa các sao, trong khi lập trình viên có thể sử dụng dữ liệu này làm nền tảng xây dựng cơ sở tri thức cho ứng dụng AI.

Số hóa bài giảng Thiên Kỷ bằng AI

Trong bản cập nhật tháng 11/2026, tác giả đã công bố kết quả một dự án nghiên cứu khá công phu: sử dụng các mô hình AI để phân tích hơn 1,6 triệu khung hình từ 17 tập bài giảng Tử Vi Đẩu Số của Nghê Hải Hạ.

Kết quả được hệ thống hóa thành ghi chú theo phương pháp Cornell, kèm mốc thời gian, 193 hình minh họa và 26 lá số được vẽ lại từ nội dung giảng dạy.

Thay vì chỉ trích xuất phụ đề, hệ thống còn phân tích bảng viết, hình minh họa và ngữ cảnh của bài giảng. Những phần không thể xác định rõ được đánh dấu riêng thay vì tự động bổ sung bằng suy đoán của AI.

Đây cũng là một ví dụ khá hay về cách ứng dụng AI để số hóa và tổ chức kiến thức truyền thống.

Hướng dẫn cài đặt Ziwei Doushu

Bạn có thể chạy dự án trực tiếp trên máy tính cá nhân với Windows, macOS hoặc Linux. Trước khi bắt đầu, hãy đảm bảo máy tính đã cài đặt Git và Node.js tương thích với Next.js 16, từ phiên bản 20.9 trở lên.

Bước 1: Tải mã nguồn

Mở Terminal hoặc Command Prompt và chạy lệnh:

git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu

Bước 2: Cài đặt thư viện

Tiếp tục chạy lệnh sau để cài đặt các thư viện cần thiết:

npm install

Nếu muốn chuẩn bị cấu hình môi trường để phát triển thêm các tính năng AI, bạn có thể tạo file .env.local từ file mẫu:

cp .env.example .env.local

Bước này có thể bỏ qua nếu bạn chỉ muốn sử dụng tính năng lập lá số và tra cứu kiến thức.

Bước 3: Khởi động ứng dụng

npm run dev

Sau khi máy chủ khởi động, mở trình duyệt và truy cập:

http://localhost:3000

Bạn cũng có thể kiểm tra mã nguồn và chạy bộ kiểm thử thuật toán bằng hai lệnh:

npm run typecheck
npm test

Nếu không muốn cài đặt, bạn có thể trải nghiệm trực tiếp phiên bản trực tuyến tại ouranic.cn.

Hướng dẫn sử dụng Ziwei Doushu

Sau khi mở ứng dụng, bạn nhập ngày tháng năm sinh, giờ sinh, giới tính và các thông tin liên quan đến nơi sinh nếu cần hiệu chỉnh thời gian.

Hệ thống sẽ tạo lá số với đầy đủ 12 cung và các sao tương ứng. Bạn có thể chọn từng cung để xem thông tin chi tiết, chuyển đổi giữa bản mệnh, đại hạn và lưu niên hoặc sử dụng thư viện kiến thức để tìm hiểu ý nghĩa của các sao.

Ngoài lập lá số cá nhân, phiên bản demo còn hỗ trợ tạo hai lá số để đối chiếu, tra cứu cổ thư, tìm kiếm nội dung kiến thức, chuyển đổi giao diện sáng tối và sử dụng trên thiết bị di động.

Lưu ý rằng giao diện và tài liệu hiện chủ yếu sử dụng tiếng Trung. Nếu chưa quen với ngôn ngữ này, bạn có thể sử dụng tính năng dịch tự động của trình duyệt hoặc tự bổ sung bản dịch tiếng Việt vào mã nguồn.

Tích hợp Ziwei Doushu với AI

Nếu đang phát triển một ứng dụng huyền học AI, bạn hoàn toàn có thể tận dụng phần lõi của Ziwei Doushu mà không cần xây dựng lại thuật toán từ đầu.

Các thành phần quan trọng được tổ chức khá rõ ràng:

Thành phầnChức năng
algorithm.tsThuật toán lập lá số và an sao
sihua.tsHệ thống Tứ Hóa và phi tinh
patterns.tsQuy tắc nhận diện cách cục
heming-knowledge.tsKiến thức đối chiếu hai lá số
true-solar-time.tsHiệu chỉnh giờ mặt trời thực
lib/classics/Thư viện cổ thư
lib/seo/Kho kiến thức có cấu trúc

Một hướng triển khai khá hợp lý là sử dụng thuật toán của dự án để tính toán lá số, sau đó truy xuất kiến thức liên quan từ cơ sở dữ liệu và chuyển kết quả cho các mô hình như GPT, Claude, Gemini hoặc DeepSeek để diễn giải bằng ngôn ngữ tự nhiên.

Thông tin ngày giờ sinhDữ liệu đầu vàoZiwei Doushu EngineTính toán và lập lá sốKnowledge Base / RAGTra cứu kiến thức liên quanGPT / Claude / GeminiDiễn giải bằng ngôn ngữ tự nhiên

Mô hình tích hợp Ziwei Doushu với AI

Cách tiếp cận này giúp AI có dữ liệu và quy tắc cụ thể để tham chiếu, thay vì giao toàn bộ việc tính toán lá số cho mô hình ngôn ngữ và dễ gặp tình trạng AI tự tạo thông tin không chính xác.

Để sử dụng bộ dữ liệu luận giải cho các dự án riêng, bạn có thể tải xuống tại trang GitHub Releases. Không cần tải toàn bộ dataset nếu chỉ sử dụng tính năng lập lá số thông thường.

Những điểm cần lưu ý

Mặc dù dự án cung cấp khá nhiều tài nguyên, phiên bản mã nguồn mở không phải là toàn bộ sản phẩm thương mại đang hoạt động trên website của tác giả.

  • Chưa tích hợp sẵn AI: Các API luận giải và phân tích lá số cần được tự triển khai. Chỉ thêm API Key sẽ không kích hoạt được tính năng này.
  • Giao diện chỉ là bản demo: Không bao gồm toàn bộ giao diện thương mại, hệ thống tài khoản, thanh toán và các tính năng nâng cao.
  • Dataset có dung lượng lớn: Nên tải theo phạm vi năm sinh hoặc nhu cầu thực tế để tiết kiệm dung lượng lưu trữ.
  • Cần Việt hóa: Đặc biệt chú ý đến múi giờ, âm lịch Việt Nam, cách xử lý giờ sinh và sự khác biệt giữa các trường phái tử vi.
  • Giấy phép sử dụng khác nhau: Mã nguồn sử dụng MIT, dataset sử dụng CC BY 4.0 yêu cầu ghi nguồn, còn nội dung trích dẫn bài giảng Nghê Hải Hạ có giới hạn sử dụng phi thương mại.

Bên cạnh đó, tử vi là một hệ thống tín ngưỡng và kiến thức truyền thống, chưa có cơ sở khoa học xác nhận khả năng dự đoán vận mệnh. Các nội dung luận giải nên được xem như tài liệu tham khảo, tìm hiểu văn hóa hoặc giải trí, không nên sử dụng thay thế cho những quyết định quan trọng về sức khỏe, tài chính hay cuộc sống.

Tổng kết

Ziwei Doushu là một dự án khá thú vị khi kết hợp kiến thức huyền học phương Đông với công nghệ hiện đại. Giá trị lớn nhất của dự án không chỉ nằm ở khả năng lập lá số mà còn ở việc công khai thuật toán, tổ chức kho kiến thức và cung cấp bộ dữ liệu có quy mô lớn cho cộng đồng.

Nếu bạn đang tìm kiếm một nền tảng để xây dựng website tử vi, chatbot huyền học, trợ lý AI chuyên ngành hoặc đơn giản là muốn tìm hiểu cách số hóa kiến thức cổ truyền, đây là một repository rất đáng để lưu lại và khám phá.

GitHub: github.com/Renhuai123/ziwei-doushu

Để lại một bình luận

Email của bạn sẽ không được hiển thị công khai. Các trường bắt buộc được đánh dấu *