Developer guides

Version-bound quickstarts, recipes, conventions, errors and receipts for the Zodiacs engine and Compute API.

Engine 1.0.0: On npm. Archive identity and release status.

Read this page as Markdown

Choose the local engine for on-device or server-local calculation. Hosted recipes send their requests to the Compute API; each guide states that boundary.

• Node quickstart

  Compute a synthetic chart in a Node process with the published package.

  Markdown
• Browser quickstart

  Bundle a chart calculation into a browser application without uploading chart inputs.

  Markdown
• Deno quickstart

  Use the installed engine through Deno's Node compatibility and a local node_modules directory.

  Markdown
• Bun quickstart

  Run an ESM chart example with Bun using the published package.

  Markdown
• Cloudflare Workers quickstart

  Bundle a fixed synthetic chart into a Worker without a hosted engine dependency.

  Markdown
• Natal chart recipe

  Calculate bodies, angles, houses and aspects from a resolved UTC instant and place.

  Markdown
• Transit recipe

  Compare positions at a target instant with a synthetic natal chart.

  Markdown
• Solar and lunar returns

  Find return instants and their charts through the techniques entry point.

  Markdown
• Synastry recipe

  Compare two synthetic natal charts with explicit input and time policies.

  Markdown
• Longitude-crossing searches

  Find longitude crossings under a sample budget and handle a refusal as a whole result.

  Markdown
• Calculation conventions

  Keep UTC, TT, UT1, frames, centres, corrections and zodiac choices explicit.

  Markdown
• Errors and refusals

  Distinguish invalid inputs, typed calculation refusals and hosted API errors.

  Markdown
• Receipts and reproduction

  Reproduce a request and track where a numerical result came from.

  Markdown
• Python hosted quickstart

  Call the hosted positions endpoint from Python without claiming a native Python engine.

  Markdown
• Hosted election search

  Search a bounded window for a declared set of sky conditions over HTTP.

  Markdown
• Deprecation policy

  Understand public API stability, experimental exclusions and removal notice.

  Markdown
• Release changelog

  Find the authoritative changes for each release and where each version came from.

  Markdown
• Developer status

  Identify the installed release, supported surfaces and remaining programme work.

  Markdown

React Native and complete sunrise-based panchang guides are not yet available.