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.6.24.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.6.24-py3-none-any.whl (23.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for agi_gui-2026.6.24.tar.gz
Algorithm Hash digest
SHA256 d476016b5cbabaf82f7db7579df24f09213ff36d4530014b099180c455f50b8f
MD5 a162e3e71d1cebc5d817ef7ac5cc78ae
BLAKE2b-256 b372f51c35ae40b528c7a6479ceafed13a2d248a0901dfa605710fccbde2ecd7

See more details on using hashes here.

Provenance

The following attestation bundles were made for agi_gui-2026.6.24.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.6.24-py3-none-any.whl.

File metadata

  • Download URL: agi_gui-2026.6.24-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.13

File hashes

Hashes for agi_gui-2026.6.24-py3-none-any.whl
Algorithm Hash digest
SHA256 b5ea96025dfb2737934a078087fb3f4bca2e98722887b6745f56fddadce69f30
MD5 e6c1ec4ea99bea8934b386bc5d5c1615
BLAKE2b-256 a503b6c3f7bd6aa565d8813b718f2b470306b8b521d4b1b080e2b6bbcf547bde

See more details on using hashes here.

Provenance

The following attestation bundles were made for agi_gui-2026.6.24-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