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

Uploaded Python 3

File details

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

File metadata

  • Download URL: agi_gui-2026.6.23.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.23.tar.gz
Algorithm Hash digest
SHA256 eacd15646c7d2fafca649f4505080356516c049d74b556a970b7f4deee073c95
MD5 060010671561516a69f45a140196ec44
BLAKE2b-256 31ed79aa684dd77f9e3e55c0c01fe1d34a31c7f77b294adcc19dbe9c3264599a

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: agi_gui-2026.6.23-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.23-py3-none-any.whl
Algorithm Hash digest
SHA256 15455d900efe7f9112d208104e7f1d3f95e15435407f5ce8df0ba160d38f3ac7
MD5 c8b70f9de22742e3591f5997e5c3992a
BLAKE2b-256 3b6e43953a847183de32efd9e74e13152043d1a851ffbf30ed4a5bfbeb177b71

See more details on using hashes here.

Provenance

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