MaRK012 commited on
Commit
92628b5
Β·
verified Β·
1 Parent(s): 79ada03

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +40 -32
README.md CHANGED
@@ -1,33 +1,41 @@
1
- # πŸ“¦ LogisticsFlow-OpenEnv
2
-
3
- A real-world OpenEnv simulation for testing AI agents on Supply Chain Management, Budgeting, and Resource Allocation.
4
-
5
- ## 🎯 The Real-World Problem
6
- Modern E-commerce fulfillment requires balancing strict budgets with customer satisfaction. AI agents must learn to prioritize high-value VIP orders, manage limited budgets, and anticipate stock-outs before they happen.
7
-
8
- This environment simulates a live warehouse dispatch system. Agents are not just playing a game; they are optimizing a simulated business.
9
-
10
- ## 🧠 Environment Features
11
- * **Strict OpenEnv Compliance:** Fully typed `Action` and `Observation` models using Pydantic.
12
- * **Continuous Partial Rewards:** Agents receive granular reward signals for every successful shipment, not just a binary score at the end.
13
- * **Dynamic State Degradation:** Customer satisfaction drops as orders age in the queue, forcing the agent to act efficiently.
14
- * **Deterministic Task Graders:** Built-in programmatic graders (Easy, Medium, Hard) that return a strict 0.0 to 1.0 score based on budget retention and order completion.
15
-
16
- ## πŸš€ Tasks & Difficulty
17
- 1. **Easy (`/reset/easy`):** Basic capability test. Agent must ship existing inventory.
18
- 2. **Medium (`/reset/medium`):** Constraint optimization. Agent is given a severely limited budget and must choose the cheapest shipping carriers to survive.
19
- 3. **Hard (`/reset/hard`):** Multi-step reasoning. The agent is faced with a "Stock-out Crisis" (0 inventory). It must realize the shortage, execute a `restock` command, and *then* fulfill the orders.
20
-
21
- ## πŸ› οΈ Action Space
22
- * `ship`: Dispatch an order (Requires `order_id` and `carrier`).
23
- * `restock`: Purchase more inventory to fulfill future orders (Requires `item`).
24
-
25
- ## πŸ“Š Observation Space
26
- * `inventory`: Current stock counts (e.g., `{"Electronics": 10}`).
27
- * `pending_orders`: Queue of orders with priority levels and age.
28
- * `budget`: Available capital.
29
-
30
- ## πŸƒ How to Run Locally
31
- 1. Install dependencies: `pip install -r requirements.txt`
32
- 2. Start the server: `python -m uvicorn main:app --port 7860`
 
 
 
 
 
 
 
 
33
  3. The environment will be available at `http://localhost:7860`
 
1
+ ---
2
+ title: LogisticsFlow OpenEnv
3
+ emoji: πŸ“¦
4
+ colorFrom: blue
5
+ colorTo: green
6
+ sdk: docker
7
+ pinned: false
8
+ ---
9
+ # πŸ“¦ LogisticsFlow-OpenEnv
10
+
11
+ A real-world OpenEnv simulation for testing AI agents on Supply Chain Management, Budgeting, and Resource Allocation.
12
+
13
+ ## 🎯 The Real-World Problem
14
+ Modern E-commerce fulfillment requires balancing strict budgets with customer satisfaction. AI agents must learn to prioritize high-value VIP orders, manage limited budgets, and anticipate stock-outs before they happen.
15
+
16
+ This environment simulates a live warehouse dispatch system. Agents are not just playing a game; they are optimizing a simulated business.
17
+
18
+ ## 🧠 Environment Features
19
+ * **Strict OpenEnv Compliance:** Fully typed `Action` and `Observation` models using Pydantic.
20
+ * **Continuous Partial Rewards:** Agents receive granular reward signals for every successful shipment, not just a binary score at the end.
21
+ * **Dynamic State Degradation:** Customer satisfaction drops as orders age in the queue, forcing the agent to act efficiently.
22
+ * **Deterministic Task Graders:** Built-in programmatic graders (Easy, Medium, Hard) that return a strict 0.0 to 1.0 score based on budget retention and order completion.
23
+
24
+ ## πŸš€ Tasks & Difficulty
25
+ 1. **Easy (`/reset/easy`):** Basic capability test. Agent must ship existing inventory.
26
+ 2. **Medium (`/reset/medium`):** Constraint optimization. Agent is given a severely limited budget and must choose the cheapest shipping carriers to survive.
27
+ 3. **Hard (`/reset/hard`):** Multi-step reasoning. The agent is faced with a "Stock-out Crisis" (0 inventory). It must realize the shortage, execute a `restock` command, and *then* fulfill the orders.
28
+
29
+ ## πŸ› οΈ Action Space
30
+ * `ship`: Dispatch an order (Requires `order_id` and `carrier`).
31
+ * `restock`: Purchase more inventory to fulfill future orders (Requires `item`).
32
+
33
+ ## πŸ“Š Observation Space
34
+ * `inventory`: Current stock counts (e.g., `{"Electronics": 10}`).
35
+ * `pending_orders`: Queue of orders with priority levels and age.
36
+ * `budget`: Available capital.
37
+
38
+ ## πŸƒ How to Run Locally
39
+ 1. Install dependencies: `pip install -r requirements.txt`
40
+ 2. Start the server: `python -m uvicorn main:app --port 7860`
41
  3. The environment will be available at `http://localhost:7860`