Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
|
@@ -1,33 +1,41 @@
|
|
| 1 |
-
|
| 2 |
-
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
|
| 14 |
-
|
| 15 |
-
|
| 16 |
-
|
| 17 |
-
|
| 18 |
-
|
| 19 |
-
|
| 20 |
-
|
| 21 |
-
|
| 22 |
-
*
|
| 23 |
-
|
| 24 |
-
|
| 25 |
-
|
| 26 |
-
* `
|
| 27 |
-
* `
|
| 28 |
-
|
| 29 |
-
|
| 30 |
-
|
| 31 |
-
|
| 32 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 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`
|