Skip to content

NachaFromMars/ziwei

Repository files navigation

Ziwei — Tử Vi Đẩu Số Full-Stack App

Chinese Astrology (紫微斗數) web app with AI interpretation, chart matching, and 100-year destiny K-line visualization.

OpenClaw Skill Tech Stack License

Overview

Ziwei is a full-stack Tử Vi Đẩu Số (Purple Star Astrology) application that combines the iztro calculation engine with AI-powered destiny interpretation. Input a birth date and get a complete 12-palace chart, detailed star system analysis, and a century-spanning fortune K-line.

Features

Feature Description
🌟 Chart Generation Full 12-palace chart from birth date (date, time, gender)
🤖 AI Interpretation Multi-model analysis: Kimi, Gemini, Claude, DeepSeek
⚖️ Chart Matching Compare two charts — tứ hóa phi tinh compatibility
📈 K-Line (100 Years) Visual fortune curve across a lifetime
📤 Share / Export Export chart as shareable image card

Tech Stack

  • Frontend: React 18, TypeScript, Vite, Tailwind CSS, Recharts
  • Astrology Engine: iztro — Purple Star calculation core
  • AI: Multi-provider (configurable via env)

Quick Start

# Dev server
cd app
npm install
npm run dev

# Production build
npm run build

Documentation

Deep-dive docs in docs/:

Folder Content
01-排盘算法 Chart calculation algorithm
02-星曜体系 Star system
03-宫位系统 Palace system (12 palaces)
04-四化飞星 Tứ hóa phi tinh (Four Transformations)
05-格局判断 Pattern / configuration judgment
06-运限系统 Luck period / fortune cycle system

Trigger Keywords (OpenClaw)

ziwei app, tử vi app, chạy ziwei, giao diện tử vi, hợp bàn, so bàn tử vi, k-line vận mệnh, 命盘, 合盘, 人生K线

Related Skills


Part of the NachaFromMars OpenClaw skill ecosystem.

Releases

No releases published

Packages

 
 
 

Contributors