Skip to main content

GLLM Misc

Description

A library containing miscellaneous utilities and helper functions for Generative AI applications.

Error Handling

Supported cache, graph/mindmap, and graph utility boundaries expose safe typed errors from gllm_misc.exceptions. These inherit both gllm-core.BaseError and ValueError; missing-dependency errors also inherit ImportError. See Error Handling for the exact code/message catalog, upstream mappings, diagnostics, catch migration, and consuming-service responsibilities. When json_repair is unavailable, the typed error directs users to install gllm-misc[json-repair] or add json_repair to the environment.

Automatic retries are deferred for this slice (user decision, 2026-10-14). Misc adds no cache retries, model retry defaults, or outer retry loops. Caller-supplied retry configuration and injected invokers' retry policies remain unchanged.


Installation

Prerequisites

Mandatory:

  1. Python 3.11+ — Install here
  2. pip — Install here
  3. uv — Install here
  4. gcloud CLI (for authentication) — Install here, then log in using:
    gcloud auth login
    

Install from Artifact Registry

This requires authentication via the gcloud CLI.

Runtime requirements include gllm-core>=0.4.54,<0.5.0, gllm-inference[google]>=0.6.181,<0.7.0, and gllm-datastore[chroma]>=0.5.102,<0.6.0. The current lockfile resolves core 0.4.58, inference 0.6.182, and datastore 0.5.102; released-package installation was verified during dependency preparation. This is not a claim that all supported versions or runtime failure paths were tested.

Unstructured graph extraction requires the optional json-repair extra; install gllm-misc[json-repair] when using it. Optional-dependency checks retain their existing import/construction timing.

uv pip install \
  --extra-index-url "https://oauth2accesstoken:$(gcloud auth print-access-token)@glsdk.gdplabs.id/gen-ai-internal/simple/" \
  gllm-misc

Local Development Setup

Prerequisites

  1. Python 3.11+ — Install here

  2. pip — Install here

  3. uv — Install here

  4. gcloud CLI — Install here, then log in using:

    gcloud auth login
    
  5. Git — Install here

  6. Access to the GDP Labs SDK GitHub repository


1. Clone Repository

git clone git@github.com:GDP-ADMIN/gl-sdk.git
cd gl-sdk/libs/gllm-misc

2. Setup Authentication

Set the following environment variables to authenticate with internal package indexes:

export UV_INDEX_GEN_AI_INTERNAL_USERNAME=oauth2accesstoken
export UV_INDEX_GEN_AI_INTERNAL_PASSWORD="$(gcloud auth print-access-token)"
export UV_INDEX_GEN_AI_USERNAME=oauth2accesstoken
export UV_INDEX_GEN_AI_PASSWORD="$(gcloud auth print-access-token)"

3. Quick Setup

Run:

make setup

4. Activate Virtual Environment

source .venv/bin/activate

Local Development Utilities

The following Makefile commands are available for quick operations:

Install uv

make install-uv

Install Pre-Commit

make install-pre-commit

Install Dependencies

make install

Update Dependencies

make update

Run Tests

make test

Contributing

Please refer to the Python Style Guide for information about code style, documentation standards, and SCA requirements.

Metadata

Release files for gllm-misc-binary 0.9.10.post1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for gllm-misc-binary 0.9.10.post1
File Actions
gllm_misc_binary-0.9.10.post1-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for gllm_misc_binary-0.9.10.post1-cp313-cp313-win_amd64.whl
gllm_misc_binary-0.9.10.post1-cp313-cp313-macosx_13_0_arm64.whl CPython 3.13 CPython 3.13 macOS 13.0+ ARM64 Details for gllm_misc_binary-0.9.10.post1-cp313-cp313-macosx_13_0_arm64.whl
gllm_misc_binary-0.9.10.post1-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for gllm_misc_binary-0.9.10.post1-cp312-cp312-win_amd64.whl
gllm_misc_binary-0.9.10.post1-cp312-cp312-macosx_13_0_arm64.whl CPython 3.12 CPython 3.12 macOS 13.0+ ARM64 Details for gllm_misc_binary-0.9.10.post1-cp312-cp312-macosx_13_0_arm64.whl
gllm_misc_binary-0.9.10.post1-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for gllm_misc_binary-0.9.10.post1-cp311-cp311-win_amd64.whl
gllm_misc_binary-0.9.10.post1-cp311-cp311-macosx_13_0_arm64.whl CPython 3.11 CPython 3.11 macOS 13.0+ ARM64 Details for gllm_misc_binary-0.9.10.post1-cp311-cp311-macosx_13_0_arm64.whl

Total release size: 2.0 MB

Release files / gllm_misc_binary-0.9.10.post1-cp313-cp313-win_amd64.whl

Download URL gllm_misc_binary-0.9.10.post1-cp313-cp313-win_amd64.whl
Size 326.6 kB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
1f3923ecbeb9af252bd87e855969be5404c7ecd3f755ca7113d84963340e9bf0
BLAKE2b-256 checksum
How to use checksums
b32f97d9749b51f07381db945efbf32e6bcf2a64af58a18f42019ea22cb9bb05
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Release files / gllm_misc_binary-0.9.10.post1-cp313-cp313-macosx_13_0_arm64.whl

Download URL gllm_misc_binary-0.9.10.post1-cp313-cp313-macosx_13_0_arm64.whl
Size 349.2 kB
Tags CPython 3.13 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
64623c1d47ef2847e6d4ac0228a9c946e6c351ec4975e65e949a09f1c7d999e6
BLAKE2b-256 checksum
How to use checksums
f2a43ec8ab0e14c57312b2b97f648517fa37d93a705c6b3a1c34891c8375d951
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Release files / gllm_misc_binary-0.9.10.post1-cp312-cp312-win_amd64.whl

Download URL gllm_misc_binary-0.9.10.post1-cp312-cp312-win_amd64.whl
Size 327.2 kB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
53a35570fa0b751efb223109cf687f58f94f11059a65b83f33665921946bf710
BLAKE2b-256 checksum
How to use checksums
a0080c4287cc0c18359fb34c02ad294a3fa62bb47474e1867798216d7cd2f289
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Release files / gllm_misc_binary-0.9.10.post1-cp312-cp312-macosx_13_0_arm64.whl

Download URL gllm_misc_binary-0.9.10.post1-cp312-cp312-macosx_13_0_arm64.whl
Size 343.0 kB
Tags CPython 3.12 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
76b7807376cd752bd1a6fbf31e26bfb6627b7db685f1566d840ffd16c42031fa
BLAKE2b-256 checksum
How to use checksums
a84f0a8bd374c2e3a7a3c05f5e301e729977868410c36089f855ab282e5e8ee4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Release files / gllm_misc_binary-0.9.10.post1-cp311-cp311-win_amd64.whl

Download URL gllm_misc_binary-0.9.10.post1-cp311-cp311-win_amd64.whl
Size 330.2 kB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
6279ed8418724aa3057d5c0c71747690d31a29b1b0904ef5fe7f0149bc74252a
BLAKE2b-256 checksum
How to use checksums
b878d092dadfadcd86ade17bf72e2432e3d76c975028fb018d84c43abb1251a2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Release files / gllm_misc_binary-0.9.10.post1-cp311-cp311-macosx_13_0_arm64.whl

Download URL gllm_misc_binary-0.9.10.post1-cp311-cp311-macosx_13_0_arm64.whl
Size 339.6 kB
Tags CPython 3.11 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
020295f80deba0f898ca3590abc644c63c6a30db956aa06aa194558008e1c998
BLAKE2b-256 checksum
How to use checksums
ac8c6393e9c7da61050827212231ab6a00beb3158beba1d20bf71b2e6bd28e4b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

Security for gllm-misc-binary 0.9.10.post1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for gllm_misc_binary-0.9.10.post1-cp313-cp313-win_amd64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 26, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page