README.md

metadata

title: 🚀 Streamlit Multi-Page Lab
emoji: 🚀
colorFrom: purple
colorTo: blue
sdk: streamlit
app_file: app.py
pinned: false
license: apache-2.0
sdk_version: 1.55.0

🚀 Streamlit Multi-Page Lab

A comprehensive collection of Streamlit experiments, data dashboards, and AI-powered tools merged into a single multi-page application. This project is designed for rapid prototyping and testing various Streamlit features and open-source templates.

🧪 Integrated Demos

1. Home: Interactive Altair charts and selection-enabled dataframes.
2. 🌍 Top Stocks: A visual ranking. Derived from companiesmarketcap.com data and logos (provided in CSV). File: 1_us-stock-top-mktcap.py
3. 📈 US Top Stock Peers: Comparative analysis. Fetches real-time market data using the yfinance package. File: 2_us-stock-top-compare.py
4. 🗺️ GDP Dashboard: Historical GDP analysis. Visualizes pre-saved World Bank data (in CSV). File: 3_global-gdp-compare.py
5. 🤖 Gemini File Q&A: RAG tool using Gemini 3.1 Flash Lite. File: 4_llm-gemini-rag.py

🏗️ Project Structure

lab-streamlit-start/
├── assets/
│   └── assets-logo/           # Brand logos for the Top Companies demo
├── data/
│   ├── data-gdp.csv           # World Bank GDP dataset
│   └── data-stock-us.csv      # Top companies market cap dataset
├── pages/                     # Multi-page implementation
│   ├── 1_us-stock-top-mktcap.py
│   ├── 2_us-stock-top-compare.py
│   ├── 3_global-gdp-compare.py
│   └── 4_llm-gemini-rag.py
├── requirements.txt           # Project dependencies
└── app.py        # Main entry point & Landing page

🛠️ Setup & Execution

Prerequisites

• Python 3.11+
• Google AI Studio API Key (for Gemini File Q&A)

Running Locally

1. Install dependencies:

   pip install -r requirements.txt
   

2. Run the application:

   streamlit run app.py
   

⚙️ Configuration

The project is configured for seamless execution in GitHub Codespaces. Check .devcontainer/devcontainer.json for pre-configured environment settings.

📚 References & Credits

This lab integrates and adapts features from the following open-source projects:

• Top Companies Market Cap: bi-cnc/top_companies_market_cap
• Stock Peer Analysis: streamlit/demo-stockpeers
• GDP Dashboard: streamlit/GDP-Dashboard
• Gemini File Q&A Source: Adapted from streamlit/llm-examples (Original Anthropic version)

---

Built with ❤️ using Streamlit, Altair, and Google Gemini.