3fb15d6282
- Make .env the single source of truth for runtime config. Remove all
`env:` blocks from SREBOT/ecosystem.config.js and TSSBOT/ecosystem.config.js
so values can't silently shadow .env. Both ecosystem files load .env via
`require('dotenv').config()` and PM2 inherits the resolved environment.
- Rename SREBOT_STORAGE_VOL_PATH → STORAGE_VOL_PATH across all readers
(BOT/utils.py, BOT/receiver_bridge.py, BOT/render_recap.py, server.js,
web/server.js, dateindex.js, scripts/*, srebot.service, tests/, README,
and both .env files). STORAGE is shared between SREBOT and TSSBOT, so the
variable shouldn't carry one bot's prefix.
- Rename per-process PORT env vars to disambiguated names so .env can be
the source of truth without collisions:
PORT (api) → SREBOT_API_PORT (server.js)
PORT (web) → SREBOT_WEB_PORT (web/server.js)
WEBHOOK_PORT → SREBOT_WEBHOOK_PORT (github_webhook_updater.py)
SREBOT_EXTERNAL_HOST/PORT/UPSTREAM_URL were already uniquely named;
they just move from ecosystem env to .env.
- TSSBOT/.env: drop GITHUB_WEBHOOK_SECRET (only srebot-webhook consumes it)
and the stale SREBOT_DEPLOY_PATH. SREBOT/.env: also drop the obsolete
SREBOT_DEPLOY_PATH (ecosystem now hardcodes __dirname).
- ecosystem.config.js no longer references SREBOT_DEPLOY_PATH; deploy path
is always __dirname of the ecosystem file.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
78 lines
2.1 KiB
Markdown
78 lines
2.1 KiB
Markdown
|
|
### Installation
|
|
|
|
1. **Clone the repository**
|
|
```bash
|
|
git clone git@github.com:FURRO404/BOTS.git
|
|
cd BOTS/SREBOT
|
|
```
|
|
|
|
2. **Set up Python virtual environment**
|
|
```bash
|
|
python3 -m venv .venv
|
|
source .venv/bin/activate
|
|
```
|
|
|
|
3. **Install dependencies**
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
4. **Configure environment variables**
|
|
```bash
|
|
nano .env
|
|
```
|
|
|
|
`.env` is the single source of truth for runtime config — `ecosystem.config.js`
|
|
has no `env:` blocks; it loads `.env` via `require('dotenv').config()` and PM2
|
|
inherits the variables when spawning each app. Keys SREBOT reads:
|
|
```env
|
|
DISCORD_KEY=your_discord_bot_token_here
|
|
DEEPL_KEY=your_deepl_api_key_here # Optional
|
|
GITHUB_WEBHOOK_SECRET=your_webhook_secret # For auto-deployment
|
|
STORAGE_VOL_PATH=/absolute/path/to/storage # Shared with TSSBOT
|
|
SREBOT_API_BEARER_TOKEN=your_internal_api_token # Optional, protects /api/*
|
|
SREBOT_API_PORT=6000
|
|
SREBOT_WEB_PORT=3001
|
|
SREBOT_WEBHOOK_PORT=9000
|
|
SREBOT_EXTERNAL_HOST=0.0.0.0
|
|
SREBOT_EXTERNAL_PORT=18081
|
|
SREBOT_EXTERNAL_BEARER_TOKEN=your_external_bridge_token # Optional, protects the bridge API and websocket
|
|
SREBOT_EXTERNAL_UPSTREAM_URL=http://127.0.0.1:6000
|
|
NODE_ENV=production
|
|
PYTHONUNBUFFERED=1
|
|
```
|
|
|
|
5. **Run the bot**
|
|
```bash
|
|
python BotScript.py
|
|
```
|
|
|
|
### AXBot bridge process
|
|
|
|
`ecosystem.config.js` now includes a dedicated PM2 app named `srebot-axbot`.
|
|
It proxies read-only SREBOT queries and broadcasts replay/GOB envelopes over
|
|
websocket on the same external port.
|
|
Its outbox/state files live under the shared storage volume configured in
|
|
`.env` via `STORAGE_VOL_PATH`.
|
|
|
|
Useful commands:
|
|
|
|
```bash
|
|
pm2 start ecosystem.config.js --only srebot-api
|
|
pm2 start ecosystem.config.js --only srebot-axbot
|
|
pm2 logs srebot-axbot
|
|
```
|
|
|
|
Clients should point their query client at:
|
|
|
|
```env
|
|
SREBOT_API_BASE_URL=http://<srebot-host>:18081
|
|
```
|
|
|
|
The bridge app logs both sides of the transfer:
|
|
- incoming client HTTP requests
|
|
- outgoing proxy responses
|
|
- websocket envelopes broadcast to connected clients
|
|
# test
|