# BettaFish — Multi-Agent Public Opinion & Sentiment Analysis

> An open-source multi-agent framework for real-time public opinion monitoring, sentiment analysis, and trend prediction built from scratch in Python.

## Install

Save as a script file and run:

# BettaFish — Multi-Agent Public Opinion & Sentiment Analysis

## Quick Use
```bash
git clone https://github.com/666ghj/BettaFish.git
cd BettaFish
pip install -r requirements.txt
python main.py
```

## 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

---
Source: https://tokrepo.com/en/workflows/asset-8b768aed
Author: Script Depot