JesebelGPT/README.md

Firmware Chat Web

ChatGPT-like web app backed by Firmware (https://docs.firmware.ai/) with SQLite logging and admin read-only APIs.

Requirements

• Node.js 22+
• FIRMWARE_API_KEY must be exported in your shell
• ADMIN_TOKEN (protects admin endpoints)

Setup

npm install
cp .env.example .env

Edit .env:

ADMIN_TOKEN=...

Export your Firmware key in the same shell you run the app:

export FIRMWARE_API_KEY=...

Note: .env is loaded by ./run.sh for non-secret config (like ADMIN_TOKEN, PORT).

Docs

• docs/USER.md
• docs/ADMIN.md

Run (dev)

./run.sh dev

• Web: http://localhost:5173
• API: http://localhost:8787

Run on LAN (example: 192.168.88.2)

Set in .env:

HOST=0.0.0.0
PORT=8787

Then run:

./run.sh build
./run.sh server

Open from another device:

• http://192.168.88.2:8787

Run (prod-ish)

./run.sh build
./run.sh server

Admin APIs

Send x-admin-token: $ADMIN_TOKEN:

• GET /api/logs
• GET /api/logs/:request_id
• GET /api/stats/summary
• GET /api/stats/models
• GET /api/stats/timeseries

Admin UI (browser)

Open:

• /admin

Enter ADMIN_TOKEN once to start a cookie-based session.