Hello and welcome to the Spacepix repository. Spacepix is educational software that allows the user to explore the NASA API and it's data from a desktop application written in Rust and built on the egui crate.
Because Spacepix is written in Rust, it should run roughly the same on Linux, Mac, and Windows.
Run gh repo clone CodeCanna/spacepix or git clone https://github.com/CodeCanna/spacepix.git
Spacepix uses Make and cargo to build and run:
make allBuilds optimized for both Linux and Windows x64 targets (MAC to come) uses--releasemake linuxBuilds for both Linux and Windows optmized uses--releasemake linuxdevBuilds for Linux x64 unoptmizedmake windowsBuilds for Windows x64 optimized uses--releasemake windowsdevBuilds for Windows x64 unoptimized
If you just want to run Spacepix you can use cargo run or cargo run --release (optimizations)
You can run Spacepix with Make using make run or make rrun for optimizations using --release
Spacepix uses NASA's API to get it's data. NASA requires that you register here to get a free API key. This will allow you to use Spacepix with no limitations.
Once you get your API key, you can enter it in Spacepix by going to Settings->Set API Key. The next time you start Spacepix your key should be used instead of DEMO_KEY.
Spacepix uses DEMO_KEY by default. This can be changed by going to Settings->Set API Key and entering in you API key.
In documentation examples, the special DEMO_KEY api key is used. This API key can be used for initially exploring APIs prior to signing up, but it has much lower rate limits, so you’re encouraged to signup for your own API key if you plan to use the API (signup is quick and easy). The rate limits for the DEMO_KEY are:
- Hourly Limit: 30 requests per IP address per hour
- Daily Limit: 50 requests per IP address per day