Aryanshh commited on
Commit
2a85ff5
Β·
1 Parent(s): 87a0116

fix: Resolve Reset Sim styling crash and stylize README markdown

Browse files
Files changed (2) hide show
  1. README.md +14 -17
  2. 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
- # NetZero Nav
 
 
 
 
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
+ ![Status](https://img.shields.io/badge/Status-Active_Simulation-brightgreen)
4
+ ![Python](https://img.shields.io/badge/Python-3.10+-blue)
5
+ ![FastAPI](https://img.shields.io/badge/Backend-FastAPI-009688)
6
+ ![Frontend](https://img.shields.io/badge/Frontend-Vanilla_JS_|_CSS-f39c12)
7
+ ![Deployment](https://img.shields.io/badge/Deployment-HuggingFace_Spaces-ffcc00)
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", "error");
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