Instructions to use tanveeerr/space-debris-yolov8 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- ultralytics
How to use tanveeerr/space-debris-yolov8 with ultralytics:
from ultralytics import YOLOvv8 model = YOLOvv8.from_pretrained("tanveeerr/space-debris-yolov8") source = 'http://images.cocodataset.org/val2017/000000039769.jpg' model.predict(source=source, save=True) - Notebooks
- Google Colab
- Kaggle
π°οΈ Space Debris Detection & Risk Assessment
A YOLOv8-powered deep learning system for detecting space debris and satellites in orbital imagery β with real-time collision risk assessment.
π Overview
Space debris poses a significant risk to operational satellites and future space missions. This project uses YOLOv8 object detection trained on orbital imagery to identify and classify Satellites and Debris in real time, and assess the collision risk level based on detected debris count.
The project includes a Streamlit web application for easy image upload and visualization, along with the complete training notebook used to develop the model.
π― Key Features
| Feature | Description |
|---|---|
| πΈ Object Detection | Detects Satellites and Debris using YOLOv8 |
| π¨ Confidence Tiers | Color-coded bounding boxes (π’ High β₯ 0.80 / π‘ Medium 0.50β0.80 / π΄ Low < 0.50) |
| π Risk Assessment | Collision risk score: LOW / MEDIUM / HIGH based on debris count |
| βοΈ Adjustable Threshold | Sidebar slider to control detection confidence |
| β‘ Fast Inference | FP16 half-precision model for faster predictions |
| π₯οΈ Web Interface | Clean Streamlit UI β no coding required to use |
π§ Model Performance
Trained for 30 epochs on orbital imagery dataset using YOLOv8 (Ultralytics v8.4.27)
| Metric | Score |
|---|---|
| Precision | 0.930 |
| Recall | 0.926 |
| mAP@50 | 0.931 |
| mAP@50-95 | 0.750 |
| Image Size | 640 Γ 640 |
| Classes | Satellite, Debris |
| Precision (Storage) | FP16 (Half) |
π¦ Project Structure
space-debris-detection/
βββ app.py # Streamlit web application
βββ space_debris_v2-1.ipynb # Model training & experimentation notebook
βββ requirements.txt # Python dependencies
βββ .gitignore
βββ README.md
β οΈ
best.pt(model weights) is not included in the repo due to file size. Download it from the Releases section below.
β¬οΈ Download Model Weights
The trained YOLOv8 model (best.pt) is available as a release asset:
- Go to Releases β
- Download
best.ptfrom the latest release - Place it in the root directory of this project (same folder as
app.py)
π Getting Started
1. Clone the repository
git clone https://github.com/tanveer-arch/space-debris-detection.git
cd space-debris-detection
2. Install dependencies
pip install -r requirements.txt
3. Download the model
Download best.pt from Releases and place it in the project root.
4. Run the app
streamlit run app.py
Open your browser at http://localhost:8501 and upload an orbital image to get started!
πΌοΈ How It Works
Upload Image β YOLOv8 Inference β Draw Bounding Boxes β Risk Assessment
β β β β
JPG/PNG best.pt model Color by confidence LOW / MEDIUM / HIGH
Risk Levels:
- π’ LOW β 0β2 debris objects detected
- π‘ MEDIUM β 3β5 debris objects detected
- π΄ HIGH β More than 5 debris objects detected
βοΈ Requirements
streamlit>=1.32.0
ultralytics>=8.0.0
opencv-python-headless>=4.9.0
numpy>=1.24.0
torch>=2.0.0
torchvision>=0.15.0
π¨βπ» Author
Tanveer β CS Student @ Nirma University, Ahmedabad Interests: Deep Learning Β· Computer Vision Β· Space Technology
π GitHub Profile
- Downloads last month
- 55