A self-hosted research app for exploring r/wallstreetbets attention and individual trades.
- Radar: ticker mentions → WSB Heat, with an optional Alpaca market overlay.
- Plays: Gain/Loss/YOLO posts → archived screenshots → vision-based position extraction and interpretation.
- Browse and analyze: Nuxt boards, filters, ticker history, read-only APIs/CLI and JSON/CSV exports.
TypeScript · Nuxt 4 · PostgreSQL · Docker Compose
Status: no hosted service or historical dataset is included; a new deployment collects new data. Daily outcome tracking is not implemented, and human acceptance gates remain incomplete. See status and limitations.
This is observational research, not financial advice. Screenshot posts are self-selected; do not infer per-ticker win rates from them.
Requires Docker Engine and Compose v2; no host Node installation is needed.
git clone https://github.com/foae/wsb-signals.git
cd wsb-signals
cp deploy/v2/.env.example deploy/v2/.env
$EDITOR deploy/v2/.envBefore starting, replace both database passwords and update their matching connection URLs; configuration details. Keep real credentials private.
docker compose -f deploy/v2/compose.yml up -d --buildOpen http://localhost:3000 for Plays or /board for the radar. An empty board is expected initially. The web binds to loopback only.
Without optional credentials, the radar is cashtag-only with no market overlay; Plays capture/media runs, but extraction waits for LLM access. See integrations.
| Topic | Guide |
|---|---|
| Configuration, integrations, persistence and operations | Deployment |
| Installation, repository layout, checks and releases | Development |
| Implementation status and known limitations | Conservation record |
| Plays behavior and remaining milestones | Product · Build plan |
| Radar scoring and architecture | Signal framework · TypeScript architecture |
| Analysis APIs, CLI and exports | Analysis guide |
| Regression fixtures and historical source | Fixtures · Parity contract |
| Provider references and project history | Sources · Roadmap |
| Contributor and release workflow | CLAUDE.md |
Original code and documentation: MIT. Third-party data, screenshots and dependencies retain their own terms; fixture attribution does not grant redistribution rights.