st-mui 0.2.5

MUI X components for Streamlit, built with Components v2. Includes DatePicker, TimePicker, and DateTimePicker.

st-mui

MUI X components for Streamlit, built with Components v2

---

Components

Component	Description	Standard Streamlit equivalent
time_picker	Clock UI, AM/PM toggle, min/max bounds	st.time_input (text field only)
date_time_picker	Combined date + time in one widget, AM/PM toggle, calendar popover	st.datetime_input (text field only)
date_picker	Calendar popover with format control	st.date_input

Installation

uv add st-mui

or with pip:

pip install st-mui

Quick start

import streamlit as st
from datetime import time, datetime, date
from st_mui import time_picker, date_time_picker, date_picker

t = time_picker(
    label="Pick a time",
    value=time(9, 30),
    ampm=True,
    key="my_time",
)

dt = date_time_picker(
    label="Select date & time",
    value=datetime.now(),
    key="my_datetime",
)

d = date_picker(
    label="Pick a date",
    value=date.today(),
    key="my_date",
)

API

time_picker

time_picker(
    label="Select a time",
    value=None,           # time object or HH:MM string
    ampm=True,            # 12-hour vs 24-hour
    min_time=None,
    max_time=None,
    disabled=False,
    on_change=None,
    key=None,
) -> time | None

date_time_picker

date_time_picker(
    label="Select date & time",
    value=None,           # datetime object or ISO string
    min_datetime=None,
    max_datetime=None,
    ampm=True,
    disabled=False,
    on_change=None,
    key=None,
) -> datetime | None

date_picker

date_picker(
    label="Select a date",
    value=None,           # date object or YYYY-MM-DD string
    min_date=None,
    max_date=None,
    format="MM/DD/YYYY",  # MUI format tokens
    disabled=False,
    on_change=None,
    key=None,
) -> date | None

Running the example

pip install st-mui
streamlit run examples/showcase.py

Development

# Clone and install
git clone https://github.com/lperezmo/st-mui.git
cd st-mui
uv sync --dev

# Build frontend
cd st_mui/frontend
npm install
npm run build
cd ../..

# Run showcase
uv run streamlit run examples/showcase.py

License

MIT