Nebulosa

Elegant astronomy for TypeScript. Supercharged by Bun.

Nebulosa is a zero dependencies, Bun-first, ESM-only TypeScript toolkit for numerical astronomy, astrophotography, and observatory control. It combines precision time and coordinate models, ephemerides, orbital mechanics, scientific image processing, astrometry, catalogs, and hardware protocols.

Requirements

• Bun — the sole runtime for the library and its tests.

Installation

bun add --trust github:tiagohm/nebulosa.ts

Development

bun i                                   # install dependencies
bun test --parallel --timeout=30000     # run the test suite
bun lint                                # lint and type-check
bun fmt --check                         # check formatting
bun fmt                                 # format the project

Inspired by

Thanks to all these projects:

• Skyfield
• Astropy
• ERFA
• Astronomia
• Astrarium

License

Released under the MIT License. Copyright © 2025 Tiago Melo.