How mukundan-304/ecosort-ai works
EcoSort is a waste-to-recovery platform: a worker submits a photo, the system identifies items, derives material and hazard guidance, recommends a compatible recovery facility, and presents instructions. Low-confidence or hazardous decisions can enter human review; corrections feed model retraining. The README also documents a classifier lifecycle with data preparation, benchmarking, evaluation gates, and promotion, plus hash-chained traceability and capacity forecasting. Runtime internals for the UI, pipeline, operations, and analytics were not sampled, so those connections reflect documented behavior rather than inspected calls.
Main entry points: pipeline.py Item Pipeline · train.py Classifier Training · vision.py Detection & Classification · evaluate.py Quality Evaluation
Components 20
Photo Intake & Guidance
- Photo UI
app/streamlit_app.py - Item Pipeline
src/ecosort/pipeline.py - Detection & Classification
src/ecosort/vision.py - Waste Knowledge
src/ecosort/knowledge.py - Worker Guidance
src/ecosort/pipeline.py
Recovery Operations
- Facility Router
src/ecosort/routing.py - Facility Configuration
configs/facilities.yaml
Review & Traceability
- Uncertainty Review Gate
src/ecosort/ops.py - Human Review
app/streamlit_app.py - Review Feedback
data/feedback/feedback.jsonl - Traceability Ledger
data/ledger.jsonl - Analytics & Forecast
src/ecosort/ops.py
Model Lifecycle
- Dataset Preparation
training/prepare.py - Image Preprocessing
src/ecosort/preprocess.py - Classifier Training
training/train.py - Evaluation Metrics
src/ecosort/evalutils.py - Quality Evaluation
training/evaluate.py - Model Promotion
training/promote.py - Deployed Models
models
Other components
- Worker
Connections 23
- Worker → Photo UI: uploads photo
README.md - Photo UI → Item Pipeline: submits image
README.md - Item Pipeline → Detection & Classification: detects items
README.md - Detection & Classification → Waste Knowledge: uses item classes
src/ecosort/vision.py - Detection & Classification → Image Preprocessing: preprocesses crops
src/ecosort/vision.py - Item Pipeline → Waste Knowledge: derives handling
README.md - Item Pipeline → Worker Guidance: produces guidance
README.md - Item Pipeline → Facility Router: requests routing
README.md - Facility Router → Facility Configuration: loads facilities
src/ecosort/routing.py - Item Pipeline → Uncertainty Review Gate: checks uncertainty
README.md - Uncertainty Review Gate → Human Review: queues review
README.md - Human Review → Review Feedback: writes corrections
README.md - Item Pipeline → Traceability Ledger: records decisions
README.md - Traceability Ledger → Analytics & Forecast: feeds analytics
README.md - Review Feedback → Dataset Preparation: feeds retraining
README.md - Dataset Preparation → Classifier Training: creates splits
README.md - Classifier Training → Image Preprocessing: uses transforms
training/train.py - Classifier Training → Evaluation Metrics: scores candidates
training/train.py - Classifier Training → Quality Evaluation: produces candidate
README.md - Quality Evaluation → Evaluation Metrics: computes gate metrics
training/evaluate.py - Quality Evaluation → Model Promotion: gates promotion
README.md - Model Promotion → Deployed Models: copies approved model
training/promote.py - Deployed Models → Detection & Classification: loads deployed classifier
README.md