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

Uploaded Python 3

File details

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

File metadata

  • Download URL: agi_gui-2026.7.17.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.17.tar.gz
Algorithm Hash digest
SHA256 b89aba5a6337b8dd48544bbe799d44caf2098a8cf0e4a27292a7f47844f10f59
MD5 1789c39f43e6d5b4a458600b9ebf92fd
BLAKE2b-256 7db125245852818b69c83d4560bb6d43feaa90e62ff8ed12a8121bc7ea020c66

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: agi_gui-2026.7.17-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.17-py3-none-any.whl
Algorithm Hash digest
SHA256 b1d6e0bf9ccb12aaccc6820f5de91d25f854c64dd3a078cba8c84eaab8e789bb
MD5 31b6c1a8a1f052b766b66182ff2d13ad
BLAKE2b-256 594722bda25c10cfd3e2a36e059d5fc4fe56404e52431c7aaf4750e9a64b131e

See more details on using hashes here.

Provenance

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