Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/imprvhub/nasa-apod-viewer
a python-based web app for fetching NASA's astronomy picture of the Day, shareable as APOD cards.
https://github.com/imprvhub/nasa-apod-viewer
apod flask nasa python vercel-deployment
Last synced: about 9 hours ago
JSON representation
a python-based web app for fetching NASA's astronomy picture of the Day, shareable as APOD cards.
- Host: GitHub
- URL: https://github.com/imprvhub/nasa-apod-viewer
- Owner: imprvhub
- License: mit
- Created: 2024-02-18T07:17:46.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-06-17T01:04:48.000Z (5 months ago)
- Last Synced: 2024-06-17T02:25:40.435Z (5 months ago)
- Topics: apod, flask, nasa, python, vercel-deployment
- Language: Python
- Homepage: https://apod-nasa-viewer.vercel.app
- Size: 13 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
## Welcome to the [Nasa Apod Viewer](https://apod-nasa-viewer.vercel.app/) Project.
This project is a Python web application built with Flask. It fetches NASA's Astronomy Picture of the Day (APOD) from the NASA API and provides functionalities to view and share the images as APOD cards.
### Demo
Visit the live app: [apod-nasa-viewer.vercel.app](https://apod-nasa-viewer.vercel.app)
### Preview
### Key Features
- Fetches the Astronomy Picture of the Day from the NASA API.
- Enables users to explore APOD images via a calendar navigation or by searching for specific dates.
- Includes a 'Shuffle' option that randomize picks for users who are uncertain which date to explore.
- Showcases a curated selection of the finest APOD images from 1995 (the inception year of APOD) to the present via the 'Featured NASA APOD per year' Recommendations section.
- Generates shareable APOD cards comprising the retrieved image, title, and description.
### Installation and Usage
To run this project locally, follow these steps:
1. Clone the repository to your local machine:
```bash
git clone https://github.com/imprvhub/nasa-apod-viewer.git
```
2. Install the required dependencies:
```bash
pip install -r requirements.txt
```
3. Set up environment variables. Ensure you have a .env file with the following variables:
```bash
NASA_API_KEY: Your NASA API key.
DATABASE_HOST: Hostname of your database.
DATABASE_USERNAME: Username for database access.
DATABASE_PASSWORD: Password for database access.
DATABASE: Name of the database.
```
4. Run the Flask application:
```bash
cd api
python3 index.py
```
Then it should be accessible at
```bash
http://localhost:5000/
```
### Conclusion:
#### Achievements
- **Efficient Management of Complex Workflow and Scripts:** Efficient Management of Complex Workflow and Scripts: Effectively handling the intricate workflow involving multiple script executions to facilitate user interaction and offer various options, such as randomization, date selection, and APOD card generation, was the primary challenge addressed in this project. Ensuring the desired outcomes following each script execution and interaction was particularly rewarding. This required orchestrating a sequence of API calls to dynamically update the APOD based on user interactions, each serving distinct purposes. Attention to detail and comprehensive testing were essential to ensure seamless functionality throughout the process.
#### Learnings
- **Enhanced Frontend-Backend Interaction:** I gained insights into achieving improved interaction between frontend scripts and Python backend processes. Previously, my approach was limited to transmitting specific data and processing it. However, this project necessitated establishing a continuous exchange of data between the frontend and backend due to the numerous scripts and interactions within the web application. It was a valuable learning experience.
### Feedback & Support
Your input matters, and I'm ready to help address any inquiries or feedback you may have. Your contributions are essential for refining the project and enhancing the overall user experience. Don't hesitate to get in touch with me:
Feel free to share your insights, recommendations, or suggestions for continuous improvement. If you encounter any challenges or require assistance, please [create a new GitHub issue](https://github.com/imprvhub/nasa-apod-viewer/issues/new). Be sure to provide a detailed description of your issue to facilitate prompt and precise support.
### License
This project is licensed under the MIT License. See the [LICENSE](https://github.com/imprvhub/nasa-apod-viewer/blob/main/LICENSE.md) file for details.