Convex + Batch Rotational Model Processing

Release 1.0.2 — Convex Integration

Optional Convex cloud database for real-time storage, querying, and re-evaluation with AI re-evaluation workflow, versioning, and historical snapshots. Weighted sentiment scoring provides stronger ranking signals.

Highlights

• Real-time analyses persisted in Convex with sentimentScore, analysisVersion, and lastUpdated
• Re-evaluate stored tickers using AI, preserving raw posts for accurate summaries
• Historical snapshots captured on every update for trend analysis

New Features

CLI Commands (run.py)

• convex-test — Test connectivity and setup
• convex-list — List analyses (sort by sentiment or mentions)
• convex-show TICKER — Detailed view with breakdowns and AI summary
• convex-reeval TICKER — AI re-evaluate from stored raw data

Python Client (convex_client.py)

Core operations:

• save_analysis, get_analysis, list_analyses, get_top_stocks, get_history

Re-evaluation queue:

• queue_revaluation, get_pending_revaluations, update_revaluation_status

Live updates:

• subscribe_to_analysis for real-time updates

Convex Schema (convex/schema.ts)

Tables:

• stockAnalyses, stockHistory, revaluationQueue

Indexes:

• by_ticker, by_ticker_timeframe, by_timeframe_updated

New fields:

• sentimentScore, analysisVersion, aiSummary, aiContext, rawPosts

Convex Functions (convex/stockAnalyses.ts)

Core functions:

• upsertAnalysis, getAnalysis, listAnalyses, getTopStocks, getHistory

Re-evaluation queue:

• queueRevaluation, getPendingRevaluations, updateRevaluationStatus

Weighted sentiment score formula:

(positive - negative) / max(1, total) × log(1 + totalMentions)

Improvements

• convex_tracker.py listing now shows sentiment strength with emojis and version indicators
• Detailed show view includes subreddit mentions, breakdowns, and AI context
• Expanded documentation with Convex setup, commands, and usage in README.md

Setup

Requirements

• convex Python package (added to requirements.txt)
• Add CONVEX_URL to .env (displayed by npx convex dev)

Quick Start

npm install
npx convex dev  # Follow prompts
python run.py convex-test

Compatibility

No breaking changes. Convex is optional—existing SQLite flows continue to work. If not using Convex, you can ignore the new commands and environment variable.

Known Issues

• First-time Convex setup requires GitHub authentication in browser
• Ensure OPENROUTER_API_KEY is set before using convex-reeval

v1.0.1

StockReddit v1.0.1

AI-Powered Reddit Stock Sentiment Analyzer

Overview

Track and analyze stock sentiment across Reddit's top investing subreddits with context-aware AI.

Key Features

• Dual Mode Operation: Fast regex or AI-powered context understanding
• Smart Ticker Validation: Auto-validates against 6,700+ real US stocks (NASDAQ, NYSE, AMEX)
• Multi-Model AI: Rotates through 9 free LLM models for 24/7 availability
• Flexible Subreddit Selection: Analyze 1-10 subreddits with range/list syntax
• Efficient Batch Processing: 16x more efficient with intelligent comment batching
• Budget Tracking: Built-in request management for cost control
• SQLite Database: Persistent storage of all mentions and sentiment data

Quick Start

# Setup
pip install -r requirements.txt

# Configure .env with Reddit API credentials
# Optional: Add OpenRouter API key for AI features

# Run
python run.py track-ai -tm -pl 50  # Track hot stocks
python run.py analyze-ai AAPL      # Analyze sentiment

Requirements

• Python 3.7+
• Reddit API credentials (required)
• OpenRouter API key (optional, for AI features)

License

MIT License

---

This release note is saved as RELEASE_NOTES.md if you'd like me to create it as a file in your project.