Run it on your computer

The best part: you can watch RISER work without any real hardware. We use a fake boiler called the simulator. The simulator pretends to be a real boiler. The agent cannot tell the difference.

Run the fake boiler

This runs the agent against the simulator:

make run-sim

You will see lines print out, about one per second. Watch the supply temperature. When the boiler is on, it goes up. When the boiler is off, it goes down. You will also see a moment where the temperature gets too hot. The agent catches this and forces the boiler to a safe state. That is the safety system working.

Run the backend

The backend needs the database running first. Then start it:

make run-backend

Now open another terminal and ask it if it is healthy:

curl localhost:8000/health

You should see {"status":"ok","db":"ok"}. That means the backend is up and can reach the database.

You can also open http://localhost:8000/docs in a web browser. That page lists every API command the backend understands. It is made for you automatically.

Run the whole demo

This is the fun one. It starts the database, the backend, the agent with its simulator, and a small web page, all at once:

make run-demo

Open the web page it prints. You will see live temperatures. You can press a button to turn the boiler on or off. Try pulling your internet for a moment. The agent keeps running and the building stays warm. When the internet comes back, the saved data catches up.

Run the operator web app

The real dashboard is a separate app. Install it once, then run it:

make web-install
make run-web

It opens at http://localhost:3000. Make sure the backend is running too, because the web app talks to it.

Run the marketing website

The public website is also separate:

make marketing-install
make run-marketing

It opens at http://localhost:4321.