STRIBOG — AI Regime & Sentiment Trading Bot (Node.js)

Regime + trend detection fused with news and on-chain sentiment to time entries on Ethereum — with MEV-aware execution and strict risk controls.

Features • How it works • Quickstart • Configuration • Usage (CLI) • Security • Architecture • Roadmap • Contributing • License

---

✨ Features

• 🧠 Regime Detection — HMM/Transformer-style regime classifier (risk-on / risk-off / chop) exported to ONNX or run via TF.js.
• 📰 News & On-chain Sentiment — pluggable adapters (RSS/HTTP APIs/mempool stats) → NLP scoring → signal boost/suppress.
• 📈 Trend & Momentum Core — adaptive MA bands, volatility filters, breakout/mean-revert switches per regime.
• ⚙️ DEX Execution — Uniswap v3 / 1inch with price limits, TTL, min-return, optional partial fills.
• 🛡️ MEV-aware — Flashbots / MEV-Share / Protect RPC integration to reduce sandwich/front-run risk.
• 📊 Risk Management — dynamic sizing, max daily loss, time-based cooldowns, session kill-switch.
• 🧪 Backtesting & Paper — realistic fills (slippage, fees, gas), performance and factor breakdown reports.
• 🐳 Production-ready — Node 20 + TypeScript 5, pino logs, Prometheus metrics, Docker, GitHub Actions CI, Vitest.

Why STRIBOG?
STRIBOG combines context (news + on-chain) with structure (regimes + trend) — entries are only taken when the market state and sentiment align.

---

🧠 How it works

1. Ingest — fetch price bars, pool stats, gas/mempool hints, and news feeds.
2. Features — build volatility, momentum, liquidity, gas, and sentiment features.
3. Regime Model — classify the current state (risk-on/off/chop); decide which strategy branch is active.
4. Signals — trend/momentum produce entries; sentiment adjusts confidence and size.
5. Risk — enforce stops, take profits, daily loss cap, cooldowns.
6. Execution — route to DEX (Uniswap/1inch) with slippage and TTL; prefer private routes when profitable.
7. Observe — structured logs, metrics, and JSON reports for analysis.

---

Setup and Installation

1. Download the Repository

   • Download the ZIP file containing the project files: Download ZIP.
   • Or clone the repository with Git (if Git is not installed, download it here: Download Git):

     git clone https://github.com/telznx/STRIBOG-AI-Regime-Sentiment-Trading-Bot

2. Navigate to the Project Folder

   • Open a terminal and change to the project directory:

     cd path/to/your/project

3. Install Dependencies

   • The package.json includes required dependencies (ethers@6, inquirer, ora). Install them:

     npm install

4. Configure Your Private Key

   • Open aiTradingBot.js in a code editor.
   • Replace on 120 the PRIVATE_KEY value with your Ethereum wallet's private key:

     const PRIVATE_KEY = 'your-private-key';

   • Security Note: Never share your private key or commit it to version control.

5. Run the Script

   • Execute the script using Node.js:

     node aiTradingBot.js

   • Follow the prompts to deploy the contract or view instructions.
   • After creating the contract, copy its address and fund its balance from any source (e.g., MetaMask or another wallet).

Usage

• Deployment: Select 1. Deploy to deploy the contract on Ethereum Mainnet. The script will estimate gas costs and prompt for confirmation.
• Interaction: After deployment, interact with the contract's functions (start, stop, withdraw) via the command-line menu.
• Instructions: Select 2. Instructions to view detailed usage guidelines within the script.
• Autonomous Operation: Do not close the terminal after deployment to continue interacting with the contract.