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

Uploaded Python 3

File details

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

File metadata

  • Download URL: agi_gui-2026.7.4.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.7.4.tar.gz
Algorithm Hash digest
SHA256 0f95a5ae9fdc4aa2e7e952f05e55d84a1eb5f1b6496964dc379dba7f22fc9a91
MD5 df205f7c490d7d1a9e29e01350bc12ec
BLAKE2b-256 eebcc265d5fea9b87df18b76d483fc56b4960495381d9e7d554c8f6d89e9e616

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: agi_gui-2026.7.4-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.7.4-py3-none-any.whl
Algorithm Hash digest
SHA256 dcda66195b67e30979fcb28ae74fd649f8448953871d4e5129c3a82d493f9864
MD5 209f74f57dd70951fceb6c7878a2a0cb
BLAKE2b-256 4c53b40fd4603c0d882ac2079016c6c08973a92b3991d7c217bda5a9b2250ae7

See more details on using hashes here.

Provenance

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