Horosa is a native macOS workstation integrating Western astrology and diverse Chinese metaphysical arts into a single, offline application. It targets users of traditional cosmology and divination, offering a unified interface to replace multiple web tools and eliminate complex runtime installations, thereby providing a streamlined, integrated, and user-friendly experience.

How It Works

This desktop application bundles Java, Python, and ephemeris runtimes within an offline .pkg installer for macOS. It employs a Java backend for core calculations, supported by a Python service layer interfacing with Swiss Ephemeris and a traditional metaphysics engine. The frontend uses React/Umi, with a Tauri (Rust) shell for native packaging and distribution.

Quick Start & Requirements

• Install: Download the offline .pkg installer (Horosa-Installer-macos-arm64-offline.pkg) and install like any macOS application.
• Prerequisites: macOS 12+ and Apple Silicon (arm64) are required. No manual Python or Java installation is necessary.
• Links: Installer: Download Link, English Guide: README_EN.md, Releases: Releases Page

Highlighted Details

• Integrates Western astrology (natal, timing, relationship, Vedic, Qizheng) and Chinese metaphysics (Bazi, Ziwei, Qimen, Liuren, Taiyi, Liuyao, Feng Shui, etc.).
• AI Analysis module supports multiple LLM providers (OpenAI, Anthropic, Gemini, Ollama) with vector retrieval and structured export.
• Features a real-time 3D celestial planetarium (Babylon.js).
• Local chart/case saving with tags, snapshots, and JSON import/export for session restore.
• Distributed as a signed, notarized .pkg for enhanced security and ease of installation.

Maintenance & Community

The project builds upon the foundational work of 郑大哥 and 荀爽 (Herakleios), acknowledging ongoing contributions from testers and fixers. Specific community channels or a public roadmap are not detailed in the provided README.

Licensing & Compatibility

Licensed under AGPL-3.0, a strong copyleft license requiring derivative works to be shared under the same terms, potentially restricting commercial use or integration with closed-source software. Distribution targets macOS 12+ on Apple Silicon. Some upstream components' licensing is noted as MIT or unclear, requiring review of THIRD_PARTY_NOTICES.md.

Limitations & Caveats

The software is currently in beta (v2.1.7 beta). Primary distribution targets Apple Silicon Macs (macOS 12+); Windows porting is indicated as a potential future effort. The AGPL-3.0 license necessitates careful consideration for commercial adoption.