# Ziwei Knows

<p align="center">
  <img width="820" alt="Ziwei Knows" src="./assets/logo.en.svg" />
</p>

<p align="center">
  <strong>A modern Zi Wei Dou Shu chart analysis tool</strong>
</p>

<p align="center">
  Precise charting · AI interpretation · yearly trends · compatibility reading · life timeline
</p>

## Overview

Ziwei Knows combines traditional Zi Wei Dou Shu knowledge, modern web interaction, and multi-model AI into a self-hostable application.

It is designed to be readable, useful, and easy to share, not just a chart viewer.

## Features

- **Precise charting** - Built on `iztro` with full 12-palace configuration
- **AI interpretation** - Structured chart analysis with multi-model support
- **Yearly trends** - Monthly and annual fortune analysis
- **Compatibility reading** - Dual-chart relationship analysis
- **Life timeline** - Long-term fortune visualization
- **Share cards** - Generate shareable destiny quote cards

## Getting Started

```bash
git clone https://github.com/ziweiknows/ziwei-chart.git
cd ziwei-chart/app
npm install
npm run dev
```

## Deployment

### Vercel

[![Deploy with Vercel](https://vercel.com/new/clone?repository-url=https://github.com/ziweiknows/ziwei-chart&project-name=ziwei&root-directory=app)

### Cloudflare Pages

[![Deploy to Cloudflare Pages](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/ziweiknows/ziwei-chart)

## Configuration

Open the in-app settings to configure your LLM API. OpenAI-compatible endpoints are supported, along with Kimi, Gemini, Claude, and DeepSeek.