Spaces:
Running
Running
| title: LiiS Circular Economy Simulator | |
| emoji: ♻️ | |
| colorFrom: green | |
| colorTo: blue | |
| sdk: streamlit | |
| sdk_version: "1.44.0" | |
| app_file: app.py | |
| pinned: false | |
| # LiiS Circular Economy Simulator | |
| A simulation framework for exploring product configurations and understanding how design, logistics, and business model choices impact circular economy performance. | |
| ## Purpose | |
| This simulator helps LiiS.com and its consortium partners (BeSafe, Hamax) evaluate: | |
| - **P&L impact** of circular business models vs. linear alternatives | |
| - **CTI performance** (Circular Transition Indicators) across product configurations | |
| - **Return grade distribution** and its effect on refurbishment costs | |
| - **Logistics optimization** for multi-cycle product flows | |
| ## CTI Framework | |
| The simulator uses [WBCSD's Circular Transition Indicators](https://www.wbcsd.org/Programs/Circular-Economy/Metrics-Measurement/Circular-transition-indicators) (CTI v3.0) to measure circularity: | |
| ### Core Indicators | |
| | Indicator | Definition | Target | | |
| |-----------|------------|--------| | |
| | **EoLRR** (End-of-Life Recovery Rate) | `(Units Recovered + Refurbished) / Total Distributed` | 72% | | |
| | **PRI** (Primary Resource Input) | `Virgin Material / Total Material` | <30% by Year 2 | | |
| | **Lifetime Extension** | `Actual Use Years / Design Lifetime` | 1.0x (full design life) | | |
| ### How CTI Flows Into P&L | |
| ``` | |
| Return Rate (80%) × Grade Quality (90% A+B) = EoLRR (72%) | |
| ↓ | |
| Units Available for 2nd Cycle | |
| ↓ | |
| Blended Cost = (New × €100 + Refurb × €20) / Total | |
| ↓ | |
| Break-even Price | |
| ↓ | |
| Profit Margin at €25/month | |
| ``` | |
| ## Project Structure | |
| ``` | |
| simulator/ | |
| ├── README.md # This file | |
| ├── CLAUDE.md # Claude Code development guidance | |
| ├── pyproject.toml # Python dependencies | |
| ├── app.py # Streamlit dashboard (main entry point) | |
| ├── products/ | |
| │ ├── besafe/ | |
| │ │ ├── config.yaml # BeSafe Beyond configuration | |
| │ │ └── image.png # Product image | |
| │ └── hamax/ | |
| │ ├── config.yaml # Hamax Outback configuration | |
| │ └── image.webp # Product image | |
| ├── branding/ # Brand assets (Futura font, logo) | |
| ├── src/ | |
| │ ├── __init__.py | |
| │ └── simulator.py # Core CTI/P&L calculations | |
| └── .claude/ | |
| └── skills/ # Claude Code skills | |
| ``` | |
| ## Product Configuration | |
| Each product has a `config.yaml` defining: | |
| - **Design specs**: Lifetime, use cycles, durability | |
| - **Cost structure**: Manufacturing, refurbishment by grade (A/B/C), logistics | |
| - **CTI parameters**: Target EoLRR, reusability indices | |
| - **Return assumptions**: Return rate, grade distribution | |
| - **Environmental data**: CO2 per manufacturing/refurbishment cycle | |
| ### Adding a New Product | |
| 1. Create `products/{product-name}/config.yaml` | |
| 2. Follow the schema in existing configs (see `products/besafe/config.yaml`) | |
| 3. Run `/analyze-product {product-name}` to validate | |
| ## Quick Start | |
| ### Run the Interactive Dashboard | |
| ```bash | |
| # Install dependencies | |
| pip install -e . | |
| # Launch the Streamlit dashboard | |
| streamlit run app.py | |
| ``` | |
| The dashboard opens in your browser with: | |
| - Product selector dropdown | |
| - Sliders for return rate, grade distribution, lease price | |
| - Live-updating CTI metrics (EoLRR, PRI, Lifetime Extension) | |
| - P&L breakdown charts | |
| - Sensitivity analysis visualization | |
| ### With Claude Code Skills | |
| ```bash | |
| # Analyze a single product | |
| /analyze-product besafe | |
| # Compare multiple products | |
| /compare-products besafe hamax | |
| # Add a new product configuration | |
| /add-product stokke | |
| ``` | |
| ### With Python | |
| ```python | |
| from src.simulator import load_product, calculate_cti, calculate_pl | |
| config = load_product("besafe") | |
| cti = calculate_cti(config) | |
| pl = calculate_pl(config, cti) | |
| ``` | |
| ## Key Concepts | |
| ### Product Grades | |
| | Grade | Condition | Action | Cost | | |
| |-------|-----------|--------|------| | |
| | **A** | Reusable as-is | Wash + inspect | €11 | | |
| | **B** | Needs refurbishment | Parts replacement | €44 | | |
| | **C** | Scrap only | Disassemble for recycling | €6 | | |
| ### Circular vs. Linear Comparison | |
| | Metric | Linear Model | Circular Model | | |
| |--------|--------------|----------------| | |
| | Units per 12-year lifecycle | 3 new | 1 new + 2 refurb | | |
| | Total cost | €300 | €140 | | |
| | CO2 emissions | 21.9 kg | 12.2 kg | | |
| | Revenue per unit | €300 | €900 (3 customers) | | |
| ## Background | |
| LiiS.com is a Norwegian subscription platform for children's products. The simulator supports: | |
| - **Innovation Norway grant applications** with auditable CTI metrics | |
| - **Consortium decision-making** for BeSafe and Hamax product design | |
| - **Operational planning** at Lundebygruppen (refurbishment partner) | |
| See the full context in the [CDO briefing document](docs/cti-framework-briefing.md). | |
| ## License | |
| Internal use only - LiiS.com consortium. | |