Mini Six Ren (小六壬占卜)

Chinese traditional divination system based on the Nine-Palace hand technique. Generate three-pass (三传) predictions and provide AI-powered analysis.

Workflow

1. Determine input mode (numbers / datetime / Chinese chars / current time)
2. Run scripts/xiaoliu.py --format json to compute the prediction
3. Check if config.yaml exists and has a model field:
   • No config (default): Display ℹ️ 当前使用 Claude Code 内置模型解读。如需使用第三方模型，请创建 config.yaml。Then use the built-in LLM to analyze the result following the "LLM Analysis" section below.
   • Has config + API key: Display ℹ️ 当前使用 <model> 解读。Run scripts/interpret.py with the prediction JSON piped in:

     uv run scripts/xiaoliu.py --now --question "问题" --format json | \
       uv run scripts/interpret.py --question "问题"
     

   • Has config, missing API key: Display ⚠️ 请在 .env 中设置 <ENV_KEY>。Fall back to built-in LLM analysis.
4. Format the report using assets/template.md

Quick Start