- Implement `sigen_daemon.py` to poll Sigenergy plant metrics and store snapshots. - Create `web_daemon.py` for serving a web interface with various endpoints. - Add debug scripts: - `debug_duplicates.py` to find duplicate target times in forecast data. - `debug_energy_forecast.py` to print baseline energy forecast curves. - `debug_oracle_evaluations.py` to run the oracle evaluator. - `debug_sigen.py` to inspect stored Sigenergy plant snapshots. - `debug_weather.py` to trace resolved truth data. - `modbus_test.py` for exploring Sigenergy plants or inverters over Modbus TCP. - Introduce `oracle_evaluator.py` for evaluating stored oracle predictions against actuals. - Add TCN training scripts in `tcn` directory for training usage sequence models.
2.7 KiB
Operations
Web UI
Start the web UI daemon:
python3 -m gibil.scripts.daemons.web_daemon
The daemon listens on:
http://0.0.0.0:8080
By default the server binds to all network interfaces so it can be reached from another machine. Override the bind address or port if needed:
export ASTRAPE_WEB_HOST='0.0.0.0'
export ASTRAPE_WEB_PORT='8080'
The host process reloads webui.py and display modules on each request. The browser polls /api/ui-version and refreshes when those files change.
Systemd Services
Install service units:
sudo cp deploy/systemd/astrape-web.service /etc/systemd/system/
sudo cp deploy/systemd/astrape-db.service /etc/systemd/system/
sudo cp deploy/systemd/astrape-sigen.service /etc/systemd/system/
sudo cp deploy/systemd/astrape-oracle.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now astrape-web.service astrape-db.service astrape-sigen.service astrape-oracle.service
Check status:
systemctl status astrape-web.service
systemctl status astrape-db.service
systemctl status astrape-sigen.service
systemctl status astrape-oracle.service
journalctl -u astrape-web.service -f
journalctl -u astrape-db.service -f
journalctl -u astrape-sigen.service -f
journalctl -u astrape-oracle.service -f
Both services run as the IPA-managed gibil user from /mnt/astrape.
Database Daemon
Install runtime dependencies:
python3 -m pip install -r requirements.txt
Create a local env file:
cp env/astrape.env.example env/astrape.env
nano env/astrape.env
Required values:
ASTRAPE_DATABASE_URL=postgresql://USER:PASSWORD@HOST:PORT/DBNAME
ASTRAPE_LATITUDE=59.0000
ASTRAPE_LONGITUDE=18.0000
Optional values:
ASTRAPE_WEATHER_FORECAST_HOURS=48
ASTRAPE_WEATHER_POLL_SECONDS=3600
ASTRAPE_WEATHER_TRUTH_LOOKBACK_DAYS=14
ASTRAPE_WEATHER_TRUTH_END_DELAY_DAYS=5
The daemons load env/*.env automatically. Existing process environment variables win over file values.
For temporary frontend tuning, enable display-only sample weather data:
ASTRAPE_WEB_SAMPLE_DATA=1
This does not write artificial data to TimescaleDB. It only changes the web UI weather API response.
Start the database ingest daemon:
python3 -m gibil.scripts.daemons.db_daemon
Current behavior:
- initializes TimescaleDB weather tables
- fetches real Open-Meteo hourly forecasts
- normalizes them through
WeatherBuilder - stores rows in
weather_forecast_points - fetches Open-Meteo archive data for resolved truth
- stores rows in
weather_resolved_truth - repeats every
ASTRAPE_WEATHER_POLL_SECONDS
No internal weather predictions are generated here. This daemon only stores external forecast and resolved-truth data for later modules.