Spaces:
Sleeping
Sleeping
Aryanshh commited on
Commit Β·
2a85ff5
1
Parent(s): 87a0116
fix: Resolve Reset Sim styling crash and stylize README markdown
Browse files- README.md +14 -17
- dashboard/app.js +6 -2
README.md
CHANGED
|
@@ -1,43 +1,40 @@
|
|
| 1 |
-
-
|
| 2 |
-
title: NetZero Nav
|
| 3 |
-
emoji: π
|
| 4 |
-
colorFrom: green
|
| 5 |
-
colorTo: blue
|
| 6 |
-
sdk: docker
|
| 7 |
-
pinned: false
|
| 8 |
-
---
|
| 9 |
|
| 10 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 11 |
|
| 12 |
**Autonomous RL logistics agent navigating global disruptions with a Net-Zero carbon mandate.**
|
| 13 |
|
| 14 |
-
## Overview
|
| 15 |
**NetZero Nav** is an AI agentic simulation environment built for logistics optimization. In modern supply chains, decision-making is a multi-objective problem: balancing financial costs, delivery speed, and environmental sustainability. This project simulates a supply chain command center where an agent (or human operator) manages electronic product manufacturing while adhering strictly to "Net-Zero" carbon quotas.
|
| 16 |
|
| 17 |
This interface serves as the visual playground and telemetry dashboard representing what an AI Reinforcement Learning (RL) agent interacts with behind the scenes via a custom FastAPI `/step` loop.
|
| 18 |
|
| 19 |
-
## The Challenge
|
| 20 |
Every logistical decision involves a strategic trade-off:
|
| 21 |
-
- **Sea Freight ($10, 10 Days, 0.1kg CO2)**: Ultra-low carbon footprint and cheap, but extremely slow.
|
| 22 |
-
- **Air Freight ($50, 2 Days, 2.0kg CO2)**: High speed fulfillment, but massive CO2 emissions and 5x the cost.
|
| 23 |
-
- **Rail Freight ($25, 5 Days, 0.5kg CO2)**: The hybrid option for balanced regional resilience.
|
| 24 |
|
| 25 |
Operators must balance raw inventory against pending order fulfillment schedules to prevent bleeding capital, while ensuring they do not breach the 1,000kg Carbon Footprint limit.
|
| 26 |
|
| 27 |
-
## Core Features
|
| 28 |
1. **Real-time Telemetry Dashboard**: A high-fidelity, reactive command console providing live readouts on Capital Balance, Carbon Footprint, and Raw Inventory limitations.
|
| 29 |
2. **Dynamic Order Routing & Cart Aggregation**: The environment automatically merges overlapping delivery constraints and cleanly manages multi-batch shipments in the `Your Orders` logistics stream.
|
| 30 |
3. **Disruption Management ("The Suez Jam")**: Triggering real-world crises blocks optimal ocean routes (e.g., SEA mode) for 7 simulation days. The agent must rapidly recompute air and rail alternatives without bankrupting the system or violating carbon quotas.
|
| 31 |
4. **ESG Strategic Offsetting**: Allows excess capital to be dynamically diverted into Carbon Offset programs, driving the footprint back down toward sustainable parameters.
|
| 32 |
5. **Headless Python RL Engine**: Driven entirely by a custom `AtlasEcoEnv` state machine with a strict Pydantic ruleset, validating constraints prior to DOM interaction.
|
| 33 |
|
| 34 |
-
## Tech Stack
|
| 35 |
- **Simulation Engine**: Custom Python RL Simulator (`env.py`)
|
| 36 |
- **Backend Infrastructure**: FastAPI (Handling continuous Step/Reset states)
|
| 37 |
- **Frontend Command Center**: Vanilla HTML/CSS/JS (Glassmorphic Enterprise aesthetic)
|
| 38 |
- **Deployment**: Fully dockerized & hosted on Hugging Face Spaces
|
| 39 |
|
| 40 |
-
## Getting Started
|
| 41 |
To run locally:
|
| 42 |
```bash
|
| 43 |
pip install fastapi uvicorn pydantic
|
|
|
|
| 1 |
+
# π NetZero Nav: Eco-Resilient Logistics
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 2 |
|
| 3 |
+

|
| 4 |
+

|
| 5 |
+

|
| 6 |
+

|
| 7 |
+

|
| 8 |
|
| 9 |
**Autonomous RL logistics agent navigating global disruptions with a Net-Zero carbon mandate.**
|
| 10 |
|
| 11 |
+
## π Overview
|
| 12 |
**NetZero Nav** is an AI agentic simulation environment built for logistics optimization. In modern supply chains, decision-making is a multi-objective problem: balancing financial costs, delivery speed, and environmental sustainability. This project simulates a supply chain command center where an agent (or human operator) manages electronic product manufacturing while adhering strictly to "Net-Zero" carbon quotas.
|
| 13 |
|
| 14 |
This interface serves as the visual playground and telemetry dashboard representing what an AI Reinforcement Learning (RL) agent interacts with behind the scenes via a custom FastAPI `/step` loop.
|
| 15 |
|
| 16 |
+
## β‘ The Challenge
|
| 17 |
Every logistical decision involves a strategic trade-off:
|
| 18 |
+
- π³οΈ **Sea Freight ($10, 10 Days, 0.1kg CO2)**: Ultra-low carbon footprint and cheap, but extremely slow.
|
| 19 |
+
- βοΈ **Air Freight ($50, 2 Days, 2.0kg CO2)**: High speed fulfillment, but massive CO2 emissions and 5x the cost.
|
| 20 |
+
- π **Rail Freight ($25, 5 Days, 0.5kg CO2)**: The hybrid option for balanced regional resilience.
|
| 21 |
|
| 22 |
Operators must balance raw inventory against pending order fulfillment schedules to prevent bleeding capital, while ensuring they do not breach the 1,000kg Carbon Footprint limit.
|
| 23 |
|
| 24 |
+
## π Core Features
|
| 25 |
1. **Real-time Telemetry Dashboard**: A high-fidelity, reactive command console providing live readouts on Capital Balance, Carbon Footprint, and Raw Inventory limitations.
|
| 26 |
2. **Dynamic Order Routing & Cart Aggregation**: The environment automatically merges overlapping delivery constraints and cleanly manages multi-batch shipments in the `Your Orders` logistics stream.
|
| 27 |
3. **Disruption Management ("The Suez Jam")**: Triggering real-world crises blocks optimal ocean routes (e.g., SEA mode) for 7 simulation days. The agent must rapidly recompute air and rail alternatives without bankrupting the system or violating carbon quotas.
|
| 28 |
4. **ESG Strategic Offsetting**: Allows excess capital to be dynamically diverted into Carbon Offset programs, driving the footprint back down toward sustainable parameters.
|
| 29 |
5. **Headless Python RL Engine**: Driven entirely by a custom `AtlasEcoEnv` state machine with a strict Pydantic ruleset, validating constraints prior to DOM interaction.
|
| 30 |
|
| 31 |
+
## π οΈ Tech Stack
|
| 32 |
- **Simulation Engine**: Custom Python RL Simulator (`env.py`)
|
| 33 |
- **Backend Infrastructure**: FastAPI (Handling continuous Step/Reset states)
|
| 34 |
- **Frontend Command Center**: Vanilla HTML/CSS/JS (Glassmorphic Enterprise aesthetic)
|
| 35 |
- **Deployment**: Fully dockerized & hosted on Hugging Face Spaces
|
| 36 |
|
| 37 |
+
## π» Getting Started
|
| 38 |
To run locally:
|
| 39 |
```bash
|
| 40 |
pip install fastapi uvicorn pydantic
|
dashboard/app.js
CHANGED
|
@@ -306,10 +306,14 @@ async function manualReset() {
|
|
| 306 |
headers: { 'Content-Type': 'application/json' },
|
| 307 |
body: JSON.stringify({ task: 'easy' })
|
| 308 |
});
|
| 309 |
-
log("Environment Reset to Day 0", "system");
|
| 310 |
await updateState();
|
|
|
|
|
|
|
|
|
|
|
|
|
| 311 |
} catch (e) {
|
| 312 |
-
log("Reset Failed", "
|
| 313 |
}
|
| 314 |
}
|
| 315 |
|
|
|
|
| 306 |
headers: { 'Content-Type': 'application/json' },
|
| 307 |
body: JSON.stringify({ task: 'easy' })
|
| 308 |
});
|
| 309 |
+
log("Environment Reset to Day 0", "SYSTEM EVENT", "Clean Base", "system");
|
| 310 |
await updateState();
|
| 311 |
+
|
| 312 |
+
// Clear history safely
|
| 313 |
+
document.getElementById('activity-log').innerHTML = '';
|
| 314 |
+
log("Dashboard Initialized", "SYSTEM", "Ready", "system");
|
| 315 |
} catch (e) {
|
| 316 |
+
log("Reset Failed", "CRITICAL ERROR", "", "alert");
|
| 317 |
}
|
| 318 |
}
|
| 319 |
|