| --- |
| title: UnifiedFinancialPlatform |
| emoji: 📈 |
| colorFrom: blue |
| colorTo: green |
| sdk: docker |
| app_port: 7860 |
| pinned: false |
| license: apache-2.0 |
| short_description: Multi-asset analysis with OpenBB and AI insights |
| --- |
| |
| # Financial Analysis Platform |
|
|
| A comprehensive multi-asset financial analysis platform built with Streamlit, providing real-time data, technical indicators, and AI-powered insights. |
|
|
| ## Features |
|
|
| ### 📈 Stock Analysis |
| - Real-time stock price data from OpenBB |
| - Technical indicators (SMA, EMA, RSI) |
| - Company profile and financial statements |
| - Revenue and net income trends |
| - TradingView chart integration |
| - Profitability metrics analysis |
|
|
| ### ₿ Cryptocurrency (Coming Soon) |
| - Real-time cryptocurrency prices |
| - Market cap and 24h volume |
| - Technical indicators for crypto assets |
| - TradingView crypto charts |
|
|
| ### 💱 Forex Trading (Coming Soon) |
| - Foreign exchange rate analysis |
| - Major, minor, and exotic pairs |
| - Pip calculator |
| - Economic calendar integration |
|
|
| ### 🔍 Market Screener (Coming Soon) |
| - Multi-criteria filtering |
| - Technical pattern recognition |
| - Sort by volume, price change, RSI |
| - Export results to CSV |
|
|
| ### 📰 News & AI Dashboard ✅ LIVE |
| - **23 Premium Sources** across 4 tiers for comprehensive coverage |
| - **Tier 1**: Bloomberg (×2), Reuters, FT, WSJ, The Economist, CNBC, MarketWatch (8 sources) |
| - **Tier 2**: BBC World, AFP, Al Jazeera, Politico, DW News (5 sources) |
| - **Tier 3**: Federal Reserve (2.0x), ECB (2.0x), Lagarde, BoE, IMF, World Bank, US Treasury (7 sources) |
| - **Tier 4**: Zero Hedge, First Squawk, Live Squawk (3 sources) |
| - **Low-latency monitoring** with 3-minute cache for trading decisions |
| - **Intelligent categorization**: Macro, Markets, Geopolitical |
| - **Professional sentiment analysis** (Positive/Negative/Neutral) |
| - **Weighted impact scoring**: Source credibility × engagement × recency |
| - **Breaking news detection** with instant alerts and priority display |
| - **Smart filtering** by category, sentiment, and impact level |
| - **Auto-refresh mode** for continuous monitoring during trading hours |
| - Powered by **Twikit** for real-time Twitter/X intelligence (free, no API costs) |
|
|
| ## Installation |
|
|
| 1. Clone the repository: |
| ```bash |
| git clone <repository-url> |
| cd FinancialPlatform |
| ``` |
|
|
| 2. Install dependencies: |
| ```bash |
| pip install -r requirements.txt |
| ``` |
|
|
| 3. Create a `.env` file based on `.env.example`: |
| ```bash |
| cp .env.example .env |
| ``` |
|
|
| 4. Configure your API keys and Twitter credentials in `.env`: |
| ``` |
| DEEPSEEK_API_KEY=your-key-here |
| NEWS_SERVICE_URL=http://localhost:5000 |
| ALPHA_VANTAGE_KEY=your-key-here |
| |
| # Twitter/X Credentials (required for real-time news monitoring) |
| TWITTER_USERNAME=your-twitter-username |
| TWITTER_EMAIL=your-email@example.com |
| TWITTER_PASSWORD=your-password |
| ``` |
|
|
| **Note**: Twitter credentials are required for real-time news monitoring. Without credentials, the system will use demo/mock data. |
|
|
| ## Usage |
|
|
| Run the application: |
| ```bash |
| streamlit run app/app.py |
| ``` |
|
|
| The application will open in your default web browser at `http://localhost:8501`. |
|
|
| ## Project Structure |
|
|
| ``` |
| FinancialPlatform/ |
| ├── app/ |
| │ ├── app.py # Main landing page |
| │ ├── pages/ |
| │ │ ├── 01_Stocks.py # Stock analysis page |
| │ │ ├── 02_Crypto.py # Cryptocurrency analysis |
| │ │ ├── 03_Forex.py # Forex analysis |
| │ │ ├── 04_Screener.py # Market screener |
| │ │ └── 05_Dashboard.py # News & AI dashboard |
| │ ├── components/ |
| │ │ ├── chart.py # Chart creation utilities |
| │ │ ├── data_sources.py # Data fetching functions |
| │ │ ├── ui.py # UI component functions |
| │ │ └── styles.py # Dark theme CSS |
| │ └── utils/ |
| │ ├── config.py # Configuration management |
| │ └── formatters.py # Data formatting utilities |
| ├── requirements.txt |
| ├── .env.example |
| └── README.md |
| ``` |
|
|
| ## Technology Stack |
|
|
| - **Frontend**: Streamlit |
| - **Data Sources**: OpenBB SDK, yfinance |
| - **Charting**: Plotly, TradingView widgets |
| - **AI**: DeepSeek API (planned) |
| - **Styling**: Custom CSS with dark theme |
|
|
| ## Features in Development |
|
|
| - [ ] Cryptocurrency data integration (Binance API) |
| - [ ] Forex data integration (Alpha Vantage) |
| - [ ] Market screener with advanced filters |
| - [ ] News aggregation service |
| - [ ] AI-powered trading insights |
| - [ ] Sentiment analysis |
| - [ ] Additional technical indicators (MACD, Bollinger Bands, ATR) |
|
|
| ## Configuration |
|
|
| ### Environment Variables |
|
|
| - `DEEPSEEK_API_KEY`: API key for AI-powered insights |
| - `NEWS_SERVICE_URL`: URL for news aggregation service |
| - `ALPHA_VANTAGE_KEY`: API key for forex data (optional) |
|
|
| ### Cache Settings |
|
|
| Data caching is configured in `utils/config.py`: |
| - Price data: 1 hour TTL |
| - Fundamental data: 24 hours TTL |
| - News data: 15 minutes TTL |
|
|
| ## Deployment |
|
|
| ### HuggingFace Spaces |
|
|
| This application is optimized for deployment on HuggingFace Spaces: |
|
|
| 1. Create a new Space on HuggingFace |
| 2. Set the Space type to "Streamlit" |
| 3. Add your environment variables in the Space settings: |
| - `DEEPSEEK_API_KEY` |
| - `NEWS_SERVICE_URL` |
| - `ALPHA_VANTAGE_KEY` |
| 4. Push your code to the Space repository |
|
|
| ### Local Development |
|
|
| For local development with hot-reload: |
| ```bash |
| streamlit run app/app.py --server.runOnSave=true |
| ``` |
|
|
| ## Contributing |
|
|
| Contributions are welcome! Please feel free to submit a Pull Request. |
|
|
| ## License |
|
|
| Apache 2.0 License |
|
|
| ## Acknowledgments |
|
|
| - OpenBB for financial data API |
| - TradingView for chart widgets |
| - Streamlit for the amazing web framework |
|
|
|
|
