https://github.com/sakhileln/space-nomad
A web application built with FastAPI and SQLite3, designed to deliver up-to-date space exploration information. It integrates data from public space APIs to showcase current missions, space news, celestial body details, and more! 🌌
https://github.com/sakhileln/space-nomad
database fastapi nasa-api spacex spacex-api spacex-launches spacex-launches---mission-tracker sqlite3
Last synced: 7 months ago
JSON representation
A web application built with FastAPI and SQLite3, designed to deliver up-to-date space exploration information. It integrates data from public space APIs to showcase current missions, space news, celestial body details, and more! 🌌
- Host: GitHub
- URL: https://github.com/sakhileln/space-nomad
- Owner: sakhileln
- License: gpl-3.0
- Created: 2024-12-13T13:13:33.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-01-10T02:36:32.000Z (9 months ago)
- Last Synced: 2025-02-03T23:59:55.117Z (8 months ago)
- Topics: database, fastapi, nasa-api, spacex, spacex-api, spacex-launches, spacex-launches---mission-tracker, sqlite3
- Language: Python
- Homepage:
- Size: 208 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project
README
# 🌌 Space Nomad: A Space Exploration Web App 🛰️
Space Nomad is a web application that provides information on space exploration, current missions, news, and details about celestial bodies. Built using FastAPI and SQLite3, this application integrates data from various space-related APIs to display up-to-date space data in a simple, user-friendly format.
## 🚀 Features
- **Current Space Missions**: View live missions in space and their status.
- **Space News**: Get the latest updates and articles related to space exploration.
- **Celestial Bodies Information**: Access detailed information about planets, moons, stars, and galaxies.
- **API Integration**: Fetch real-time data from space APIs (like NASA, SpaceX, and others).
## 🔧 Tech Stack
- **Backend**: FastAPI (for building a modern web API)
- **Database**: SQLite3 (lightweight relational database)
- **APIs**: Integration with various space-related APIs (NASA, SpaceX, etc.)
- **Frontend**: Simple HTML and CSS for displaying data (can be expanded later)
## ⚙️ Installation
1. Clone the repository:
```bash
git clone https://github.com/sakhileln/Space-Nomad.git
cd Space-Nomad
```
2. Install Poetry:
If you don't have Poetry installed, you can install it globally by running:
```bash
curl -sSL https://install.python-poetry.org | python3 -
```
For other installation methods, refer to the official Poetry installation guide.
3. Install dependencies using Poetry:
```bash
poetry install
```
Poetry will automatically create a virtual environment and install the required dependencies listed in `pyproject.toml`.
4. Activate the virtual environment:
```bash
poetry shell
```
5. Run the FastAPI app:
```bash
uvicorn main:app --reload
```
The app will now be available at http://127.0.0.1:8000 in your browser.
## 🌐 Usage
- **Homepage**: Displays the main space exploration news and details of ongoing missions.
- **Missions Page**: A list of space missions, both past and ongoing, with their current status.
- **Celestial Bodies Page**: Detailed information on planets, moons, and stars.
- **News Section**: Displays the latest articles and space-related news updates.
## 🔌 APIs
This app integrates with space APIs to fetch real-time data:
- **NASA API**: For space exploration data, images, and mission updates.
- **SpaceX API**: For current SpaceX missions and launches.
- **Other APIs**: Additional APIs for astronomical data (planets, moons, etc.).
You can extend the app to include more APIs or create your own endpoints to expose space data.
## 📄 Database
The project uses SQLite3 for storing basic information like user preferences or data caching. The database is lightweight and easy to set up, making it perfect for smaller-scale applications. You can extend this as needed for more complex use cases.
## 🚀 Future Features
- Interactive map for space missions and celestial bodies.
- User authentication to save preferences.
- Extend with more APIs (e.g., Hubble, SpaceNews, etc.).
- Responsive frontend for mobile devices.
## 👥 Contributing
We welcome contributions! If you'd like to help improve Space-Explora, feel free to fork the repo and create a pull request. Here’s how you can contribute:
1. Fork the repository.
2. Create a new branch for your changes.
3. Implement your changes.
4. Test your code.
5. Submit a pull request with a description of what you've done.
## 📞 Contact
If you have any questions or suggestions, feel free to open an issue in this repository or contact us directly.
- Sakhile III
- [LinkedIn Profile](https://www.linkedin.com/in/sakhile-ndlazi)
- [GitHub Profile](https://github.com/sakhileln)