How siddharth-magesh/sentimatrix works
Sentimatrix is a sentiment-analysis toolkit whose primary workflow accepts text or scraped reviews, analyzes sentiment and emotion, and can produce LLM-powered insights and exported results. It also supports audio, image, and video inputs, multiple scraper and LLM providers, batch analysis, and visualizations. The graph emphasizes documented entry points and sampled calls; provider families are grouped at their existing directories because their individual implementations were not inspected.
Main entry points: main.py Sentimatrix API · base.py Scraper base · multimodal.py Multimodal analysis · platforms Platform scrapers
Components 25
Entry & orchestration
- CLI
sentimatrix/cli.py - Sentimatrix API
sentimatrix/main.py - Pipeline
sentimatrix/core/pipeline.py
Review collection
- Platform scrapers
sentimatrix/providers/scrapers/platforms - Scraper base
sentimatrix/providers/scrapers/platforms/base.py - HTTPX scraper
sentimatrix/providers/scrapers/httpx_scraper.py - Playwright scraper
sentimatrix/providers/scrapers/playwright_scraper.py - Commercial scrapers
sentimatrix/providers/scrapers/commercial - Rate limiting
sentimatrix/providers/scrapers/rate_limiter.py
Analysis
- Sentiment analysis
sentimatrix/analysis/sentiment.py - Emotion detection
sentimatrix/analysis/emotion.py - Multimodal analysis
sentimatrix/analysis/multimodal.py - Audio/image/video input
sentimatrix/input/handlers.py
Provider integrations
- HuggingFace models
sentimatrix/providers/models/huggingface.py - LLM manager
sentimatrix/providers/llm/manager.py - LLM providers
sentimatrix/providers/llm - Provider interfaces
sentimatrix/providers/base.py
Results & support
- Exporters
sentimatrix/output/exporters.py - Formatters
sentimatrix/output/formatters.py - Visualizations
sentimatrix/output/visualizers.py - Cache
sentimatrix/core/cache.py - Configuration
sentimatrix/core/config.py - Structured logging
sentimatrix/core/logger.py
Other components
- User
- External APIs and sites
Connections 28
- User → CLI: invokes
README.md - User → Sentimatrix API: uses
README.md - CLI → Sentimatrix API: delegates to
sentimatrix/cli.py - Sentimatrix API → Pipeline: orchestrates
sentimatrix/main.py - Sentimatrix API → Platform scrapers: initializes
sentimatrix/main.py - Sentimatrix API → Sentiment analysis: calls
sentimatrix/main.py - Sentimatrix API → Emotion detection: calls
sentimatrix/main.py - Sentimatrix API → Multimodal analysis: calls
sentimatrix/main.py - Sentimatrix API → LLM manager: uses
sentimatrix/main.py - Sentimatrix API → Exporters: uses
sentimatrix/main.py - Sentimatrix API → Formatters: uses
sentimatrix/main.py - Sentimatrix API → Visualizations: uses
sentimatrix/main.py - Platform scrapers → Scraper base: extends
sentimatrix/providers/scrapers/platforms/__init__.py - Scraper base → Rate limiting: uses
sentimatrix/providers/scrapers/platforms/base.py - Scraper base → HTTPX scraper: selects scraper
- Scraper base → Playwright scraper: selects scraper
- HTTPX scraper → Rate limiting: acquires limits
sentimatrix/providers/scrapers/httpx_scraper.py - Platform scrapers → External APIs and sites: scrapes
README.md - Commercial scrapers → External APIs and sites: requests content
README.md - Multimodal analysis → Audio/image/video input: transcribes and captions
sentimatrix/analysis/multimodal.py - Multimodal analysis → Sentiment analysis: analyzes text
sentimatrix/analysis/multimodal.py - Multimodal analysis → Emotion detection: uses
sentimatrix/analysis/multimodal.py - Sentiment analysis → HuggingFace models: predicts with
sentimatrix/analysis/sentiment.py - Emotion detection → HuggingFace models: predicts with
sentimatrix/analysis/emotion.py - LLM manager → LLM providers: manages
- LLM providers → External APIs and sites: generates via
README.md - LLM manager → Provider interfaces: uses interface
sentimatrix/providers/llm/manager.py - HuggingFace models → Provider interfaces: implements
sentimatrix/providers/models/huggingface.py