RGPT · Stoxello

RGPT – Documentation | Stoxello

Stoxello | RGPT

RGPT is an automated cryptocurrency trading application for Robinhood Crypto accounts. It combines a live market dashboard, an AI decision engine powered by the OpenAI API, a rules-based backtesting engine, and a full trading bot runtime into a single web application. RGPT ships as ready-to-run software: deploy the published container image with Docker Compose, or install the Windows desktop edition from the installer included in your Stoxello distribution.

RGPT is aimed at individual traders who want to experiment with AI-driven strategies in a controlled way: demo mode is the default, live trading is off until explicitly enabled per symbol, and risk guards are shared across the bot. A 30-day trial starts automatically on first run; a license key is required afterward.

Product: RGPT
Platforms: Docker (Linux/Windows hosts) · Windows desktop edition
Distribution: Docker image (ghcr.io/stoxello/rgpt) or Windows installer from your Stoxello distribution
Type: Web dashboard / trading bot

Key Features

AI trading decisions – the OpenAI-powered engine analyzes market data and proposes buy/sell decisions through a configurable strategy catalog.
Robinhood Crypto execution – signed API integration for orders and positions, with a live-trade switch that stays off unless explicitly enabled.
Multi-symbol operation – one instance schedules multiple symbols independently, each with its own strategy, timeframe, sizing, cycle interval, pause state, and positions.
Live dashboard – real-time price charts, status snapshots, orders, trades, and event log streamed to the browser.
Backtesting – historical strategy simulation with configurable execution policy before risking capital.
First-run setup wizard – a public /Setup page collects OpenAI keys, Robinhood API credentials, admin account, and CCA endpoints, then locks itself to admins only.
Licensing with 30-day trial – signed license keys bound to a machine ID; the /License page shows plan, expiry, days remaining, and activation.
Docker or Windows deployment – published container image, or a Windows installer for the desktop edition.

System Requirements

Requirement	Details
Runtime	Docker Desktop or Docker Engine with Docker Compose; alternatively Windows 10/11 for the desktop installer
Network	Internet access to pull the image and reach OpenAI and Robinhood Crypto APIs; web UI published on port 8080 by default
Credentials	OpenAI API key; Robinhood Crypto API key plus base64 private key
Licensing	None during the included 30-day trial; an RGPT license key afterward
Persistent storage	A named Docker volume (rgpt-data by default) for settings, databases, and bot state

Installation

The recommended deployment uses the published container image ghcr.io/stoxello/rgpt:latest. The Compose file is provided with your Stoxello RGPT distribution. Windows users can instead run the RGPT installer (MSI) from the same distribution, which installs a desktop edition that opens the same dashboard in its own window.

Install Docker Desktop (Windows/macOS) or Docker Engine with the Compose plugin.
Place the supplied docker-compose.yml in a folder on the Docker host.
Start the stack — Compose pulls the image and creates the persistent data volume.
Open http://localhost:8080/Setup, complete the first-run form, and save.
Restart the container so bootstrap settings load, then log in with the admin account you created.
After the 30-day trial, activate a purchased key on the /License page.

docker compose up -d          # pull ghcr.io/stoxello/rgpt:latest and start
docker compose ps             # verify the container is running
docker compose logs --tail 100 rgpt-web   # inspect startup logs

# after saving the /Setup form:
docker compose restart rgpt-web

# update later:
docker compose pull
docker compose up -d

Usage

Day-to-day operation happens in the browser at http://localhost:8080. The home dashboard shows the selected symbol's price, status, and controls; a Running symbol dropdown switches between assets. Settings lets administrators choose which symbols run and configure each one's strategy, timeframe, trade sizing, cycle interval, pause state, and live-trading state — risk guards and the strategy catalog stay shared. Charts, Live, Backtest, Strategies, Orders, Trades, Status, Operations, and EventLog pages cover monitoring, research, and history.

Live trading places real orders. Keep LIVE_TRADE=false and leave live trading unchecked until your keys, risk settings, and license are confirmed. Cryptocurrency trading involves risk, including possible loss of capital; you are responsible for your trading decisions, credentials, and account permissions.

Configuration

Most configuration is done through the /Setup page and the in-app Settings screens; values are stored in the persistent volume (/app/data): bootstrap_settings.json, ai_settings.json, bot_settings.json, and SQLite databases. Key environment variables available in the Compose file:

RGPT_HTTP_PORT (default 8080) – host side of the port mapping; change it if port 8080 is busy.
ASPNETCORE_URLS / APP_URL – bind address inside the container (keep http://0.0.0.0:8080/).
RGPT_DATA_DIR and RGPT_BOOTSTRAP_SETTINGS_PATH – where setup and runtime state are stored.
ConnectionStrings__Identity – SQLite identity database location.
LIVE_TRADE – master live-trading switch; false by default.
CCA_API_URL / CCA_WEBSOCKET_URL – market-data endpoints, defaulting to host.docker.internal:5200.
RGPT_CONTAINER_NAME / RGPT_DATA_VOLUME – override when running additional instances alongside the first.

To activate licensing after the trial, paste your purchased key on the /License page; keys are bound to the machine ID shown there. A full reset requires docker compose down --volumes, which removes setup, users, license state, and stored bot data.