Purpose
Precomputed ephemeris rows for tools that need stable, documented positions instead of guessed or repeatedly recalculated values.
Static ephemeris archive for AI
AI Ephemeris Data
A preview dataset and generator for AI-readable planetary positions. The archive is designed for static lookup, validation, and experiments without calling a live calculation API.
Coordinates
UTC timestamps, Julian Day UT, geocentric apparent tropical ecliptic longitude and latitude. No houses, Ascendant, or location-specific data.
Preview data
The default branch keeps only tiny example files. Full generated datasets are discovered through the catalog and published outside main, currently on Hugging Face as monthly ZIP archives.
AI entry point
AI agents should start with catalog.json. A short crawler-oriented summary is available as llms.txt. The catalog points to available dataset indexes and keeps broad generated archives separate from this small project repository. Generated ranges may use monthly ZIP archives; open the listed monthly index, download the matching month, then read the daily JSONL/GZIP file inside it.
https://raw.githubusercontent.com/ephemeris-ai/ai-ephemeris-data/main/catalog.jsonSample file
Download or inspect a 10-minute AI lookup example file: data/10min/2026/2026-01-01.jsonl.gz
php generator/read_example.php data/10min/2026/2026-01-01.jsonl.gz 1
php examples/nearest_lookup.php data/10min/2026/2026-01-01.jsonl.gz 2026-01-01T12:17:00Z MoMatch and event lookup
For a match or timed event, convert the scheduled local time to UTC, read the matching daily file directly or from the matching monthly ZIP archive, and use the scheduled row or a short event window. See Match and Timed Event Usage.
Related live tools
For interactive astrology calculations, chart graphics, daily influences, and experimental AI data preparation, see On-line Astrology. This static archive remains the recommended source for automated bulk lookup.
Generate locally
A preview PHP runtime package is included in packages/swetest-php-0.1.3-preview.zip. Add local Swiss Ephemeris .se1 files and follow Generate Data From Scratch. Runtime 0.1.3-preview (2026-07-10) includes fixes from an independent audit against the Swiss Ephemeris 2.10.03 C sources; see "Data revision notes" in the README.
Preview status: this repository does not bundle Swiss Ephemeris .se1 files. Verify licensing requirements before publishing larger generated archives or redistributing calculation backends.