Skip to main content

AGI-GUI

PyPI version Python versions License: BSD 3-Clause API docs

agi-gui provides the UI dependency bundle for Streamlit pages. It depends on the headless agi-env runtime and adds reusable page helpers and UI packages.

Quick Install

pip install agi-gui

Use agi-env for worker/headless runtimes. Use agi-gui for Streamlit pages and local UI sessions.

File Picker

agi_gui.file_picker provides a reusable Streamlit popover picker for pages that need server-side path selection without exposing arbitrary filesystem access.

from agi_gui.file_picker import agi_file_picker

selected_path = agi_file_picker(
    "Browse dataframe",
    roots={"Project": active_app_export_dir},
    key=f"{project_name}:dataframe_picker",
    patterns=["*.csv", "*.parquet", "*.json"],
    container=st.sidebar,
)

The picker validates manual paths and dataframe selections against the configured roots, keeps widget keys namespaced, and can optionally save uploaded files when the caller provides an explicit upload_dir.

UX Widgets

agi_gui.ux_widgets provides small compatibility wrappers for newer Streamlit primitives. Pages can adopt modern controls while still running on older UI runtimes.

from agi_gui.ux_widgets import compact_choice, status_container, toast

selected = compact_choice(
    st.sidebar,
    "Stages file",
    available_stages_files,
    key="index_page",
    default=available_stages_files[0],
)

with status_container(st, "Running pipeline...", state="running") as status:
    run_pipeline()
    status.update(label="Pipeline completed", state="complete")
    toast(st, "Pipeline completed", state="success")

compact_choice uses st.segmented_control or st.pills when available and falls back to selectbox for long lists or older Streamlit versions.

Widget Registry

agi_gui.widget_registry provides a typed registry for reusable widgets. It gives pages and docs a single discovery point without breaking direct imports from agi_gui.file_picker or agi_gui.ux_widgets.

from agi_gui import default_widget_registry, get_widget

registry = default_widget_registry()
rows = registry.as_rows()
file_picker = get_widget("file_picker")
same_picker = get_widget("agi_file_picker")

The default registry includes file selection, compact choice, action buttons, confirmation, status, empty-state, notice, and toast widgets.

Repository

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agi_gui-2026.7.31.tar.gz (28.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agi_gui-2026.7.31-py3-none-any.whl (23.9 kB view details)

Uploaded Python 3

File details

Details for the file agi_gui-2026.7.31.tar.gz.

File metadata

  • Download URL: agi_gui-2026.7.31.tar.gz
  • Upload date:
  • Size: 28.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for agi_gui-2026.7.31.tar.gz
Algorithm Hash digest
SHA256 f0132c5038a11cf4d35a60f4dddeac41c7ecf551d4dbdee62cfeae58c30e2f93
MD5 69524d20e76a657a2bb43267df117c2b
BLAKE2b-256 fd9ebc3e3431e0a9325c98c67dd2e10e3388ce9bb66efdccdd8146c832ad75b5

See more details on using hashes here.

Provenance

The following attestation bundles were made for agi_gui-2026.7.31.tar.gz:

Publisher: pypi-publish.yaml on ThalesGroup/agilab

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agi_gui-2026.7.31-py3-none-any.whl.

File metadata

  • Download URL: agi_gui-2026.7.31-py3-none-any.whl
  • Upload date:
  • Size: 23.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for agi_gui-2026.7.31-py3-none-any.whl
Algorithm Hash digest
SHA256 a274db32233dbdf143ede78a5b6b12ed27facc1cfc6c769698999862a6e3d7bd
MD5 63b2e85687b8dbb88753030577586e1b
BLAKE2b-256 035ec0d41613579ef8a32b34cde21bfd74eeb82fee6bdc2c94d1d380a8170d95

See more details on using hashes here.

Provenance

The following attestation bundles were made for agi_gui-2026.7.31-py3-none-any.whl:

Publisher: pypi-publish.yaml on ThalesGroup/agilab

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page