TradeMood

TradeMood is a Python-based, web-accessible dashboard for real-time financial market sentiment analysis and trading decision support. Built with Streamlit, it integrates sentiment analysis using a pre-trained RoBERTa model (finiteautomata/bertweet-base-sentiment-analysis), fetches market data and social media content, generates trading signals, and tracks trades for financial instruments like gold futures (GC=F). Still requires fine tuning.

---

🔧 Features

• 🖥️ Interactive Web Dashboard powered by Streamlit.
• 📊 Real-Time Sentiment Analysis using a RoBERTa-based model.
• 📈 Trading Signal Generation based on sentiment trends (BUY, SELL, HOLD).
• 💰 Trade Management with position tracking and P&L calculation.
• 📅 Scheduled Sentiment Pipeline every 5 minutes during COMEX hours.
• 🗄️ SQLite Database for caching and trade history.
• 🔍 Detailed Trade History with styled P&L metrics.
• ⚠️ Robust Error Handling and logging.
• 🔄 Modular Architecture for easy extension.
• 📉 Market Data Integration (e.g., Yahoo Finance GC=F).
• 🧪 Unit Tests for key components.

---

📁 Project Structure

TradeMood/
├── README.md
├── requirements.txt
├── LICENSE
├── trademood/
│   ├── core/
│   │   ├── database_handler.py
│   │   ├── error_handler.py
│   │   ├── trade_tracker.py
│   │   ├── models/
│   │   │   ├── sentiment_result.py
│   │   │   ├── trading_signal.py
│   │   │   └── trend_signal.py
│   │   ├── sentiment/
│   │   │   ├── analyzer.py
│   │   │   ├── fetcher.py
│   │   │   ├── pipeline.py
│   │   │   ├── trend_generator.py
│   │   │   └── signal_generator.py
│   ├── api/
│   │   └── sentiment_api.py
│   ├── dashboard/
│   │   └── app.py
│   └── tests/
│       └── test_sentiment.py
├── scripts/
│   └── run_dashboard.py
├── data/
│   └── sentiment_cache.db
├── examples/
│   └── config.yaml
└── docs/
    └── screenshots/

---

🚀 Getting Started

Prerequisites

• Python 3.10.5
• Virtual environment (recommended)
• SQLite database
• API keys (Yahoo Finance, X API, etc.)

Install Dependencies

pip install -r requirements.txt

▶️ Installation

From the project root (where setup.py is):

pip install -e .

Run the App

streamlit run scripts/run_dashboard.py

Access the dashboard at: http://localhost:8501

---

📚 Usage

1. View Sentiment Trends for GC=F
2. Check Trading Signals (BUY, SELL, HOLD)
3. Manage Trades: Open/close positions, track P&L
4. Review History in styled trade table
5. Edit config.yaml for API and symbols

---

🧩 Supported Instruments

• ✅ Gold Futures (GC=F)
• 🚧 Add more via fetcher.py and trade_tracker.py

---

🛠 Developer Notes

• Add new instruments in fetcher.py, trade_tracker.py
• Change model in analyzer.py
• Extend API in sentiment_api.py

---

🧪 Testing

pytest trademood/tests/

---

📸 Screenshots

---

---

---

---

🌐 Roadmap

• 📈 More instruments (stocks, forex, crypto)
• 🧠 Multi-language sentiment models
• 💼 Live broker integration
• ⚙️ Config UI

---

🤝 Contributing

git clone https://github.com/your-username/TradeMood.git
cd TradeMood

---

📜 License

MIT License — see LICENSE.

---

📬 Contact

• Email: a.k.y.dorgham@gmail.com
• GitHub Issues: TradeMood Issues
• Connect: LinkedIn | GoogleScholar | ResearchGate | ORCiD

---

⚠️ Limitations

• No automated order execution
• Limited offline functionality
• SQLite not suited for large data
• Sentiment model limitations