RockGroup
Documentationv1.0

Live AI Sentiment Engine
Technical Guide

A transparent, honest walkthrough of what this system is, how it works, what it was built with, and — importantly — what it is not.

Contents
  1. 01.Overview
  2. 02.The Two Dashboards
  3. 03.Architecture
  4. 04.Data Sources
  5. 05.Scoring Methodology
  6. 06.Market Data
  7. 07.Limitations & Honesty
  8. 08.Built by Agentic AI

01. Overview

What is this?

The Rock Group AI Sentiment Engine is a real-time financial intelligence dashboard that monitors three live data streams — press releases, market news, and SEC 8-K reports — and applies large language model (LLM) scoring to each item as it arrives. Every signal is scored for sentiment, urgency, and potential market impact, then streamed instantly to your dashboard.

It is a tool for awareness and signal discovery. It surfaces information you might otherwise miss in the noise and gives you a structured, scored view of what is happening across publicly traded companies right now.

95% built by Agentic AI. This entire platform — from the ingestion pipeline to the dashboard UI — was built almost entirely by agentic AI systems working autonomously. That includes both major frontier models (Claude & Grok) and locally hosted open-source agentic models (devstral, phi4, granite3) running locally. The locally hosted models played a significant role in building the data pipeline, reducing token costs substantially and demonstrating that frontier-quality agentic work is no longer exclusive to proprietary APIs. Humans shaped the product vision, crafted precise prompts, and provided ongoing judgment — intervening where necessary to clear infrastructure hurdles and environmental limitations beyond the agents’ control. The machines executed the engineering.

Plain English: Think of it as a research assistant that reads thousands of press releases, news articles, and SEC 8-K reports per day, assigns each one a sentiment score from 0 to 10, and shows you the most relevant ones first. It does not trade for you, advise you, or guarantee any outcome.


02. The Two Dashboards

Live AI Sentiment Engine vs. Advanced AI

There are two dashboard views, each designed for a different level of engagement.

Live AI Sentiment Engine
Three-column real-time feed (Press Releases · News · SEC). Clean card view with sentiment badges, score tiers, and configurable metric columns. Best for a quick real-time overview of what is moving.
→ Open dashboard
Advanced AI
All the same live data, plus a personal watchlist, a paper portfolio tracker, ticker grouping, freshness-based opacity dimming, and score-tier tooltips. Built for users who want to track specific names over time.
→ Open dashboard

Both dashboards share the same live data pipeline and scoring model. The Advanced view adds personal context (watchlist, portfolio) on top of the same underlying signals.


03. Architecture

How it is built

The system has four distinct layers: data ingestion, local processing, cloud sync, and real-time delivery to the browser.

🌐Data Sources
EXTERNAL
PR WireNews APIsSEC EDGAR RSS
raw text firehose
⚙️Local Processing Layer
ON-PREMISE
Python PipelineLLM Scoring (OpenAI / Local Model)Sentiment Score 0–10
SQLite text_db+SQLite market_dbMarket data cross-reference
sync_to_cloud_db · every 1s
☁️Cloud Database
CLOUD
pr_datanews_datasecapi_data
PostgreSQLRealtime Engine (postgres_changes)
WebSocket Realtime · instant push on INSERT
🖥️Next.js Dashboard
BROWSER
Live AI Sentiment EngineAdvanced AI Dashboard
React stateSupabase JS clientNew card → < 1s latency

The sync module is a lightweight Python watcher that runs continuously on the server. It checks each table every second for new rowids, upserts new rows to the cloud database immediately, and also runs an independent market data sweep every 3 seconds to backfill any delayed market metrics.

The browser never polls. Once the page loads, it opens a persistent WebSocket to the cloud database Realtime. New rows push to the browser the instant Supabase receives them — typically within 1 second of the original event.


04. Data Sources

What data does it monitor?

Three distinct data streams feed the system simultaneously.

PR
Press Releases
Corporate press releases from publicly traded companies — earnings, product launches, executive changes, strategic announcements. High signal-to-noise ratio. Source URL is a premium feature.
NS
Market News
Financial news articles from market news providers covering macro events, analyst upgrades/downgrades, sector moves, and breaking company news. Broader coverage, more noise than PR.
SEC
SEC Filings (EDGAR)
Official regulatory filings submitted to the SEC — 8-K (material events), 10-K (annual reports), 10-Q (quarterly reports), S-1 (IPO registrations), and more. Identified by accession number. Only filings with a resolved ticker symbol are surfaced on the dashboard.

Note on SEC coverage: We currently track SEC 8-K reports only. Many SEC filings are submitted by entities (mutual funds, insiders, foreign filers) that do not have exchange-listed tickers. The pipeline automatically filters those out — only filings with a confirmed ticker symbol reach the dashboard.


05. Scoring Methodology

How are scores generated?

Each incoming item passes through an LLM-based scoring pipeline before it reaches the dashboard. The model reads the full text of the article, press release, or filing and returns a structured JSON output that includes a sentiment score, a sentiment direction label, and a plain-English justification.

Score Scale (0 – 10)
9 – 10MAJOR CATALYSTHigh-probability market-moving event. Significant price action likely.
7 – 8HIGH SIGNALClearly positive event with meaningful upside potential.
5 – 6MODERATEMildly impactful. Possible upside but not a clear catalyst.
0 – 4ROUTINENeutral or low-impact event. Informational only.

The LLM also outputs a directional label (BULLISH · BEARISH · NEUTRAL · MIXED) and a justification sentence explaining the reasoning. Both are visible on each card.

Scores are computed at ingestion time and stored. They do not update retroactively — a score reflects the model's assessment of the text at the moment it was processed.


06. Market Data

What market metrics are shown?

In addition to the LLM sentiment score, each card can display live and at-score market metrics. These are cross-referenced from a separate market data database and attached to the row at sync time — or backfilled up to 3 seconds later if the market data was not yet ready when the text item first arrived.

Public FloatOutstanding shares available to the public
Daily VolumeTotal shares traded on the day of the event
RVOLRelative volume — today's volume vs. 20-day average
Bid/Ask SpreadSpread at the time the score was computed
Price Change %Intraday price change at the moment of scoring
Dollar VolumeDollar-weighted volume at score time and live
Last Price at ScoreShare price at the exact moment the signal was scored

Not all metrics are available for every item. Market data availability depends on whether the ticker was actively trading when the signal was processed.

Market data disclaimer: All market metrics displayed are sourced from publicly available data feeds and are provided for reference purposes only. Accuracy is not guaranteed. Users should independently verify any market data against their own trusted sources before making any portfolio or trading decisions. Rock Group assumes no liability for data discrepancies or delays.


07. Limitations & Honesty

What this is not

We believe in being direct about what this tool does and does not do. These are real limitations, not fine print.

This is not financial advice
Nothing on this dashboard constitutes investment advice, a recommendation to buy or sell, or a guarantee of any market outcome. It is an informational tool.
LLM scores are probabilistic, not certain
The AI model can misread context, miss irony, be confused by technical jargon, or simply be wrong. A score of 9 does not mean a stock will move — it means the model assessed the text as high-impact based on its training.
Current dashboard shows real-time data only
The live dashboard streams new data from the moment the pipeline starts. Historical records exist in our database and will be made available to premium users in a future release.
Latency is ~1 second, not zero
Data flows from the source through local processing, then to Supabase, then to your browser. Total end-to-end latency is typically under 2 seconds from when an event is scored. It is fast, not instantaneous.
SEC 8-K coverage only
We currently track SEC 8-K reports (material event disclosures) only. Other SEC forms like 10-K and 10-Q will be added in the future. Only 8-K filings with a resolved exchange-listed ticker are shown. Entities without a ticker (funds, insiders, foreign registrants) are filtered out automatically.
Market data may be delayed or absent
Market metrics are attached asynchronously. Some items may show partial market data if the market database did not yet have the information at processing time.
This is not a trading system
There is no execution, no order routing, no backtesting engine in this product. This is a signal surface layer — what you do with the signals is entirely your own decision. Rock Group is developing a separate automated trading engine product that is not yet publicly available.

08. Built by Agentic AI

How was this built?

This platform was almost entirely designed and built by agentic AI and large language models working in iterative loops with a human directing the architecture and goals.

The entire codebase — the Python ingestion pipeline, the real-time sync script, the Next.js dashboard components, the TypeScript types, the scoring logic, the market data cross-referencing, and this documentation page — was generated, debugged, and refined through conversations with AI coding agents. The human role was directing intent, reviewing outputs, and making product decisions. The AI did the implementation.

Why does this matter?

A system like this — a real-time multi-source financial intelligence platform with LLM scoring, live market data cross-referencing, WebSocket delivery, and a configurable React dashboard — would have taken a team of engineers months to build. It was assembled in days, primarily through agentic AI. That is the actual state of the technology in 2026. This platform is a working demonstration of that.

The scoring pipeline itself uses LLMs to read raw financial text and produce structured output. The real-time delivery infrastructure was designed with AI assistance.

We are not hiding this. We think it is something worth being proud of. The barrier to building sophisticated, genuinely useful software has collapsed. What truly matters now is the quality of your judgment: deciding what to build, how to direct the AI tools, and when to apply deep subject matter expertise. The tools have become extraordinarily capable.

Ready to explore?

Open the live dashboard and see signals arriving in real time. The green LIVE indicator means the WebSocket is connected and new data will appear without a page refresh.

Live AI Sentiment Engine →Advanced AI Dashboard →

Rock Group · AI Intelligence Documentation · Last updated June 2025
Questions? Contact us

↑ Back to top