BettaFish — Multi-Agent Public Opinion & Sentiment Analysis

Introduction

BettaFish is a multi-agent system for public opinion monitoring and sentiment analysis. It orchestrates multiple LLM-powered agents to collect, analyze, and predict trends across social media and news sources, all built from scratch without depending on external agent frameworks.

What BettaFish Does

• Monitors public opinion across multiple platforms in real time
• Performs deep sentiment analysis using multi-agent collaboration
• Predicts future trends based on historical data patterns
• Breaks information filter bubbles by aggregating diverse viewpoints
• Generates structured reports with actionable insights

Architecture Overview

BettaFish uses a from-scratch multi-agent architecture where specialized agents handle data collection, NLP processing, sentiment scoring, and trend forecasting. Agents communicate through a message-passing system, with a coordinator agent orchestrating workflows. The system supports pluggable LLM backends and stores results in a local database for historical analysis.

Self-Hosting & Configuration

• Requires Python 3.9+ and an LLM API key (OpenAI, local models supported)
• Configure data sources and monitoring keywords in the settings file
• Supports Docker deployment for containerized setups
• Database stores historical analysis for trend comparison
• Customizable agent behaviors through configuration files

Key Features

• Framework-free multi-agent design for full control and transparency
• Supports multiple LLM providers including local models
• Real-time monitoring with configurable alert thresholds
• Historical trend analysis and future prediction capabilities
• Extensible plugin system for custom data sources

Comparison with Similar Tools

• LangChain Agents — general-purpose; BettaFish is purpose-built for opinion analysis
• CrewAI — framework-dependent; BettaFish has zero framework dependencies
• AutoGen — conversation-focused; BettaFish specializes in data-driven analysis
• Haystack — search/RAG oriented; BettaFish focuses on sentiment and trend prediction

FAQ

Q: Does BettaFish require a paid LLM API? A: It supports both commercial APIs and local open-source models via compatible endpoints.

Q: What data sources does it monitor? A: It supports configurable sources including social media platforms, news feeds, and custom RSS inputs.

Q: Can I run it fully offline? A: Yes, when paired with a local LLM like Ollama, no external API calls are needed.

Q: Is it suitable for enterprise use? A: The architecture supports scaling, but review the GPL-2.0 license for commercial use requirements.

Sources

• https://github.com/666ghj/BettaFish
• https://deepwiki.com/666ghj/BettaFish