mcli-framework 7.6.0__py3-none-any.whl → 7.6.1__py3-none-any.whl

mcli/ml/dashboard/overview.py

@@ -4,11 +4,8 @@ import streamlit as st
 
 # Try to import streamlit-extras for enhanced UI
 try:
-    from mcli.ml.dashboard.streamlit_extras_utils import (
-        section_header,
-        info_card,
-        vertical_space,
-    )
+    from mcli.ml.dashboard.streamlit_extras_utils import info_card, section_header, vertical_space
+
     HAS_EXTRAS = True
 except ImportError:
     HAS_EXTRAS = False
@@ -32,7 +29,7 @@ def show_overview():
             </h3>
         </div>
         """,
-        unsafe_allow_html=True
+        unsafe_allow_html=True,
     )
 
     st.markdown("---")
@@ -41,10 +38,11 @@ def show_overview():
     section_header(
         "🎯 What is Politician Trading Tracker?",
         "Your comprehensive tool for analyzing Congressional stock trades",
-        divider="blue"
+        divider="blue",
     )
 
-    st.markdown("""
+    st.markdown(
+        """
     This dashboard provides **real-time access** to Congressional stock trading disclosures,
     allowing you to track when U.S. politicians buy and sell stocks, analyze their patterns,
     and make informed investment decisions.
@@ -55,56 +53,56 @@ def show_overview():
     🔍 **Early Insights**: Politicians may have access to non-public information through briefings
     💡 **Smart Money**: Following experienced investors can inform your strategy
     📊 **Transparency**: Make use of public disclosure data for better decisions
-    """)
+    """
+    )
 
     vertical_space(2)
 
     # Key Features
-    section_header(
-        "✨ Key Features",
-        "Powerful tools for trading analysis",
-        divider="green"
-    )
+    section_header("✨ Key Features", "Powerful tools for trading analysis", divider="green")
 
     col1, col2, col3 = st.columns(3)
 
     with col1:
-        st.markdown("""
+        st.markdown(
+            """
         ### 📊 Data Tracking
         - **Real-time updates** from official sources
         - **Historical data** going back years
         - **Multiple sources**: Senate, House, Senate Stock Watcher
         - **Automated scraping** for latest disclosures
-        """)
+        """
+        )
 
     with col2:
-        st.markdown("""
+        st.markdown(
+            """
         ### 🤖 ML Predictions
         - **Machine learning models** for stock prediction
         - **Monte Carlo simulations** for risk analysis
         - **Pattern recognition** in trading behavior
         - **Price forecasting** based on historical data
-        """)
+        """
+        )
 
     with col3:
-        st.markdown("""
+        st.markdown(
+            """
         ### 💼 Trading Tools
         - **Paper trading** integration (Alpaca)
         - **Portfolio tracking** and management
         - **Risk assessment** tools
         - **Performance analytics**
-        """)
+        """
+        )
 
     vertical_space(2)
 
     # Quick Start Guide
-    section_header(
-        "🚀 Quick Start Guide",
-        "Get started in 3 easy steps",
-        divider="violet"
-    )
+    section_header("🚀 Quick Start Guide", "Get started in 3 easy steps", divider="violet")
 
-    st.markdown("""
+    st.markdown(
+        """
     ### Step 1: Explore Trading Data
 
     👉 Navigate to **"Scrapers & Logs"** to:
@@ -128,61 +126,63 @@ def show_overview():
     - Replicate politician trades
     - Track your performance
     - Compare to market benchmarks
-    """)
+    """
+    )
 
     vertical_space(2)
 
     # Page Navigation Guide
-    section_header(
-        "🗺️ Page Navigation Guide",
-        "Explore all available features",
-        divider="orange"
-    )
+    section_header("🗺️ Page Navigation Guide", "Explore all available features", divider="orange")
 
     # Create expandable sections for each page category
     with st.expander("📊 **Data & Monitoring Pages**", expanded=True):
-        st.markdown("""
+        st.markdown(
+            """
         - **Pipeline Overview**: System status and data processing metrics
         - **Scrapers & Logs**: Manual and automated data collection from government sources
         - **System Health**: Monitor data pipeline health and API connections
         - **LSH Jobs**: Background job status and processing queues
-        """)
+        """
+        )
 
     with st.expander("🤖 **ML & Predictions Pages**"):
-        st.markdown("""
+        st.markdown(
+            """
         - **Predictions**: Enhanced ML predictions based on politician trading patterns
         - **Monte Carlo Predictions**: Probabilistic simulation of price paths and returns
         - **Model Performance**: Evaluation metrics for ML models
         - **Model Training & Evaluation**: Train new models and compare performance
-        """)
+        """
+        )
 
     with st.expander("💼 **Trading & Portfolio Pages**"):
-        st.markdown("""
+        st.markdown(
+            """
         - **Trading Dashboard**: Full-featured paper trading interface
         - **Test Portfolio**: Simplified portfolio testing and tracking
         - **Paper trading** via Alpaca API integration
         - Track performance against politician portfolios
-        """)
+        """
+        )
 
     with st.expander("⚙️ **Technical & DevOps Pages**"):
-        st.markdown("""
+        st.markdown(
+            """
         - **CI/CD Pipelines**: Monitor build and deployment pipelines
         - **Workflows**: Track automated workflow executions
         - **ML Processing**: Data preprocessing and feature engineering
         - **Debug Dependencies**: Troubleshoot installation and import issues (useful for alpaca-py debugging)
-        """)
+        """
+        )
 
     vertical_space(2)
 
     # FAQ Section
-    section_header(
-        "❓ Frequently Asked Questions",
-        "Common questions answered",
-        divider="gray"
-    )
+    section_header("❓ Frequently Asked Questions", "Common questions answered", divider="gray")
 
     with st.expander("**Q: Is this legal? Can I really track politician trades?**"):
-        st.markdown("""
+        st.markdown(
+            """
         **A:** Yes, absolutely! The STOCK Act (Stop Trading on Congressional Knowledge Act)
         requires members of Congress to publicly disclose their stock trades within 45 days.
         This app aggregates and analyzes publicly available data.
@@ -191,10 +191,12 @@ def show_overview():
         - Senate eFiling system
         - House Financial Disclosure reports
         - Senate Stock Watcher (GitHub dataset)
-        """)
+        """
+        )
 
     with st.expander("**Q: How recent is the data?**"):
-        st.markdown("""
+        st.markdown(
+            """
         **A:** Data freshness depends on the source:
 
         - **Senate Stock Watcher**: Updated daily from official sources
@@ -203,10 +205,12 @@ def show_overview():
 
         Note: Due to the 45-day disclosure requirement, trades are not real-time.
         You're seeing what politicians bought/sold 1-6 weeks ago.
-        """)
+        """
+        )
 
     with st.expander("**Q: Can I actually trade based on this data?**"):
-        st.markdown("""
+        st.markdown(
+            """
         **A:** Yes! The dashboard includes:
 
         - **Paper Trading**: Practice with virtual money via Alpaca paper trading API
@@ -218,10 +222,12 @@ def show_overview():
         - Politician trades are disclosed 45 days late
         - This is for educational/informational purposes
         - Always do your own research before investing
-        """)
+        """
+        )
 
     with st.expander("**Q: Which politicians can I track?**"):
-        st.markdown("""
+        st.markdown(
+            """
         **A:** The dashboard tracks:
 
         - All U.S. Senators
@@ -230,10 +236,12 @@ def show_overview():
         - Committee members with oversight of industries
 
         Search by name in the **Predictions** or **Scrapers & Logs** pages.
-        """)
+        """
+        )
 
     with st.expander("**Q: How do the ML predictions work?**"):
-        st.markdown("""
+        st.markdown(
+            """
         **A:** The system uses multiple techniques:
 
         1. **Historical Pattern Analysis**: Identifies successful trading patterns
@@ -243,10 +251,12 @@ def show_overview():
         5. **Risk Metrics**: Calculates probability of profit, Value at Risk, confidence intervals
 
         See the **Model Training & Evaluation** page for technical details.
-        """)
+        """
+        )
 
     with st.expander("**Q: What data sources does this use?**"):
-        st.markdown("""
+        st.markdown(
+            """
         **A:** Multiple official and curated sources:
 
         **Primary Sources:**
@@ -258,20 +268,24 @@ def show_overview():
         - UK Companies House API (for UK company data)
         - Yahoo Finance (for stock prices and fundamentals)
         - Alpaca API (for trading and market data)
-        """)
+        """
+        )
 
     with st.expander("**Q: Is my trading data private?**"):
-        st.markdown("""
+        st.markdown(
+            """
         **A:** Yes! This is a personal dashboard:
 
         - Paper trading portfolios are stored locally or in your Supabase instance
         - No trading data is shared publicly
         - API keys are stored securely in Streamlit secrets
         - You control your own data
-        """)
+        """
+        )
 
     with st.expander("**Q: What if I find a bug or have a feature request?**"):
-        st.markdown("""
+        st.markdown(
+            """
         **A:** Contributions welcome!
 
         - **Report bugs**: Open an issue on GitHub
@@ -280,10 +294,12 @@ def show_overview():
         - **Documentation**: Help improve the docs
 
         This is an open-source project built for the community.
-        """)
+        """
+        )
 
     with st.expander("**Q: Why are some pages showing errors or not loading?**"):
-        st.markdown("""
+        st.markdown(
+            """
         **A:** Some pages require optional dependencies that may not be installed:
 
         **Common Issues:**
@@ -300,46 +316,49 @@ def show_overview():
            - Troubleshooting suggestions
 
         **Note:** Most pages have graceful fallbacks and will work with demo data if dependencies are missing.
-        """)
+        """
+        )
 
     vertical_space(2)
 
     # Getting Started Actions
-    section_header(
-        "🎬 Ready to Get Started?",
-        "Choose your path",
-        divider="rainbow"
-    )
+    section_header("🎬 Ready to Get Started?", "Choose your path", divider="rainbow")
 
     col1, col2, col3 = st.columns(3)
 
     with col1:
-        st.markdown("""
+        st.markdown(
+            """
         ### 🔍 **Explore Data**
         Start by browsing recent politician trades
 
         👉 Go to **Scrapers & Logs**
-        """)
+        """
+        )
         if st.button("View Trading Data", key="btn_scrapers", use_container_width=True):
             st.info("Navigate to 'Scrapers & Logs' in the sidebar →")
 
     with col2:
-        st.markdown("""
+        st.markdown(
+            """
         ### 📊 **Run Analysis**
         See ML predictions and simulations
 
         👉 Go to **Monte Carlo Predictions**
-        """)
+        """
+        )
         if st.button("Analyze Stocks", key="btn_monte_carlo", use_container_width=True):
             st.info("Navigate to 'Monte Carlo Predictions' in the sidebar →")
 
     with col3:
-        st.markdown("""
+        st.markdown(
+            """
         ### 💼 **Start Trading**
         Create a paper trading portfolio
 
         👉 Go to **Trading Dashboard**
-        """)
+        """
+        )
         if st.button("Paper Trade", key="btn_trading", use_container_width=True):
             st.info("Navigate to 'Trading Dashboard' in the sidebar →")
 
@@ -347,7 +366,8 @@ def show_overview():
 
     # Disclaimers
     st.markdown("---")
-    st.markdown("""
+    st.markdown(
+        """
     ### ⚠️ Important Disclaimers
 
     - **Not Financial Advice**: This tool is for educational and informational purposes only
@@ -359,19 +379,23 @@ def show_overview():
 
     **Legal Note**: All data comes from public sources. This dashboard aggregates
     publicly disclosed information under the STOCK Act and is compliant with all regulations.
-    """)
+    """
+    )
 
     vertical_space(1)
 
     # Footer
-    st.markdown("""
+    st.markdown(
+        """
     <div style='text-align: center; color: #666; padding: 2rem 0;'>
         <p>Built with ❤️ for transparent government and informed investing</p>
         <p style='font-size: 0.9rem;'>
             Data sources: Senate.gov • House.gov • Senate Stock Watcher • Yahoo Finance
         </p>
     </div>
-    """, unsafe_allow_html=True)
+    """,
+        unsafe_allow_html=True,
+    )
 
 
 if __name__ == "__main__":