OpAstro CLI

Open Engine for Deterministic Astrology

OpAstro is a high-performance Python engine, local API, and terminal CLI running on Swiss Ephemeris for building deterministic horoscopes.

Built for Developers

An astrology engine offering explicit determinism and premium explainability.

Local First

Run entirely local. No cloud dependencies, no rate limits, and 100% control of the Python calculation runtime.

Swiss Ephemeris

Leverages robust astronomical data to guarantee precision planetary longitudes instead of loose estimations.

TUI & CLI

Fully interactable interface straight from your shell. Generate rich markdown reports instantly in the terminal.

Explainable Workflows

Unlike black-box logic, OpAstro provides "explainer" outputs so you can see exactly which planetary aspect or transit triggered every meaning within your generated horoscope report.

FastAPI Integration

Includes a lightweight local REST API out of the box to instantly build integrations and web clients connecting directly to the engine.

Frequently Asked Questions

Common questions about OpAstro Engine vs Premium Apps

What is OpAstro CLI?

OpAstro is an open-core Python package and command-line interface that allows developers to run rigorous Swiss Ephemeris calculations locally, generating deterministic horoscope reports without relying on SaaS platforms.

How is it different from NumerologyAPI.com?

OpAstro CLI provides the open-source deterministic engine and lightweight meanings suitable for local dev workflows. NumerologyAPI.com provides production-grade premium narrative packs and enterprise delivery endpoints.

What dependencies are required to run the CLI?

You only need Python 3.11+. The installation handles compiling the Swiss Ephemeris C-library underneath via PySWe.

Does the tool support JSON extraction?

Yes. By appending the `--json` flag to commands, you bypass markdown/HTML rendering and receive structured raw JSON, perfect for ingestion into larger web applications.

How can I contribute to the open-source engine?

Check out our GitHub repository. We welcome PRs for algorithm optimization, more planetary interpretations, and additional testing coverage!