RDjarbeng/rwanda_energy_calculator
Domain:
environment and energyCreator:
Rdj
Host:
User Interface to calculate energy units (kW/h) for Rwanda energy group based on RWF inputs and vice versa. Python implementation
# Rwanda Energy Calculator
A web application for calculating electricity costs and units according to Rwanda Energy Group (REG) tariffs, with a detailed breakdown by tier.
Built with FastHTML. App is deployed with Onrender here
## Features
- **Calculate Units from Cost:**
Enter the amount (RWF) you wish to spend on electricity and get the corresponding kilowatt-hours (kWh) you will receive, including an optional field for any initial amount already paid.
- **Calculate Cost from Units:**
Enter the number of units (kWh) consumed to estimate the total cost (RWF), with a detailed breakdown by tariff tier.
- **Tiered Breakdown:**
See how your payment or usage is distributed across REG tariff tiers (Tier 1, 2, 3) and VAT.
- **Live Calculation:**
Instant results and breakdown as you type, powered by FastHTML and HTMX.
- **Static HTML Build:**
Generates static pages for deployment (e.g., Netlify).
## REG Tariffs (as implemented)
- **Tier 1:** Up to 15 kWh @ 89 RWF/kWh
- **Tier 2:** 16–35 kWh @ 212 RWF/kWh
- **Tier 3:** Above 35 kWh @ 249 RWF/kWh
- **VAT:** 18% applied to all charges
View Official REG Tariffs
## Usage
### 1. Online
Visit the deployed site (if available) or run locally.
### 2. Local Development
**Requirements:**
- Python 3
- fasthtml package
`pip install python-fasthtml`
**Recommended Environment:**
If you use Anaconda, it is recommended to create a separate environment for this project and activate it before running any commands:
```bash
conda create -n rwanda-energy python=3.11
conda activate rwanda-energy
```
**Run locally:**
```bash
python main.py
```
or (if using Netlify/Serverless)
```bash
python netlify/functions/app.py
```
**Build static HTML:**
```bash
python build.py
```
The output will be in the `dist/` directory.
## How It Works
- Enter your payment amount to see how many units you will get, with an optional field for initial payment (useful for monthly purchases).
- Enter number of units consumed to see the cost and how it fall …