Skip to content

feat(streamlit-eda): add deployment recipe, CSV file uploader, and updated docs#440

Open
GeoSegun wants to merge 4 commits into
mainfrom
feat/streamlit-eda-deployment-recipe
Open

feat(streamlit-eda): add deployment recipe, CSV file uploader, and updated docs#440
GeoSegun wants to merge 4 commits into
mainfrom
feat/streamlit-eda-deployment-recipe

Conversation

@GeoSegun
Copy link
Copy Markdown
Member

@GeoSegun GeoSegun commented May 25, 2026

Streamlit EDA Dashboard — Template Improvements

This PR makes the cpu-streamlit-eda template fully deployable and discoverable on Saturn Cloud.


Changes

1. Added .saturn/saturn.json deployment recipe

The template had no recipe file, so users had to configure everything manually. The new recipe pre-configures:

  • Base image (saturn-python:2025.05.01)
  • Git repository clone path
  • Working directory
  • start_script to install dependencies via requirements.txt
  • Streamlit server command bound to 0.0.0.0:8000 (required by Saturn Cloud's proxy)

Users can now launch this template from the Saturn Cloud UI and get a working deployment immediately.

2. Updated app.py — CSV file uploader

The app previously hardcoded the Tips dataset with hardcoded column names. It now:

  • Adds a CSV file uploader in the sidebar so users can bring any dataset
  • Falls back to the built-in Tips dataset when no file is uploaded
  • Auto-detects categorical and numeric columns from whatever data is loaded
  • Uses @st.cache_data on both the default and uploaded data loaders for performance

3. Updated README.md

Rewrote the README to document:

  • Full feature overview table
  • "Uploading Your Own Data" section: format requirements, column requirements, good dataset examples table, what to avoid, step-by-step upload instructions
  • Updated tech stack table (added Seaborn and Matplotlib)
  • Saturn Cloud deployment section explaining the recipe
  • Local setup instructions

4. Registered template in .saturn/templates-hosted.json and .saturn/templates-enterprise.json

The template was absent from both registry files, which meant it would not appear on the Saturn Cloud platform even after the recipe was added. Added an entry to both files:

  • Title: Streamlit EDA Dashboard (Python)
  • Thumbnail: dashboard.png
  • Weight: 2000 (after OpenClaw at 1950)
  • Recipe path: examples/data-science-analystics/cpu-streamlit-eda/.saturn/saturn.json

Testing

Deployed and verified on Saturn Cloud:

  • App starts without errors
  • Tips dataset loads on first visit
  • CSV file upload works and re-renders all filters and charts dynamically
  • Categorical filter and numeric distribution chart update correctly with uploaded data

- Adds missing deployment recipe so the template works out of the box
- Sets start_script to pip install -r requirements.txt (uses existing file)
- Fixes command to bind on 0.0.0.0:8000 for Saturn proxy compatibility
- Single git repository entry with standard /home/jovyan/examples clone path
- Uses saturn-python:2025.05.01 image, large instance type
@GeoSegun GeoSegun force-pushed the feat/streamlit-eda-deployment-recipe branch from f37721e to 54e0e82 Compare May 25, 2026 18:29
Olusegun Durojaye added 2 commits May 25, 2026 22:02
- Replace hardcoded Tips dataset with a sidebar file uploader
- Falls back to Tips dataset when no file is uploaded (with info message)
- Filter column is now dynamic — auto-detects categorical columns
- Chart column is now dynamic — user picks any numeric column to visualize
- App now works with any CSV, not just the Tips dataset
…loud deployment

- Rewrites dataset section to document the file uploader feature
- Adds dedicated 'Uploading Your Own Data' section with:
  - Supported format (CSV, UTF-8, single header row)
  - Column type requirements (at least one categorical + one numeric)
  - Table of good dataset examples with example column types
  - What to avoid (large files, nested headers, purely numeric CSVs)
  - Step-by-step upload instructions
- Adds feature overview table
- Updates tech stack to include seaborn and matplotlib
- Adds Saturn Cloud deployment section explaining the saturn.json recipe
- Updates local setup and resource links
@GeoSegun GeoSegun changed the title feat(streamlit-eda): add .saturn/saturn.json deployment recipe feat(streamlit-eda): add deployment recipe, CSV file uploader, and updated docs May 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant