Skip to main content

Sigil Python Framework Module: LlamaIndex

sigil-sdk-llamaindex provides callback handlers that map LlamaIndex workflow/agent events into Sigil generation recorder lifecycles.

Installation

pip install sigil-sdk sigil-sdk-llamaindex
pip install llama-index

Quickstart

from sigil_sdk import Client
from sigil_sdk_llamaindex import with_sigil_llamaindex_callbacks

client = Client()
config = with_sigil_llamaindex_callbacks(None, client=client, provider_resolver="auto")
# query_engine = index.as_query_engine(callback_manager=config["callback_manager"])

Native callback manager wiring

from sigil_sdk import Client
from sigil_sdk_llamaindex import with_sigil_llamaindex_callbacks

client = Client()
config = with_sigil_llamaindex_callbacks(None, client=client, provider_resolver="auto")
# query_engine = index.as_query_engine(callback_manager=config["callback_manager"])

Conversation mapping

Conversation ID precedence:

  1. conversation_id / session_id / group_id
  2. thread_id
  3. fallback sigil:framework:llamaindex:<run_id>

Metadata and lineage

  • Required: sigil.framework.run_type
  • Optional lineage: sigil.framework.run_id, sigil.framework.thread_id, sigil.framework.parent_run_id, sigil.framework.component_name, sigil.framework.retry_attempt, sigil.framework.event_id

Provider resolver

Model prefix inference:

  • gpt-/o1/o3/o4 -> openai
  • claude- -> anthropic
  • gemini- -> gemini
  • fallback custom

Troubleshooting

  • Reuse stable workflow/session IDs to keep conversation grouping stable.
  • Keep capture_inputs/capture_outputs enabled while validating mappings.
  • Call client.flush() at checkpoints and client.shutdown() on exit.

Metadata

Release files for sigil-sdk-llamaindex 0.9.3

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

Source distribution (sdist)

Source distribution for sigil-sdk-llamaindex 0.9.3
File Size Uploaded
sigil_sdk_llamaindex-0.9.3.tar.gz 9.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sigil-sdk-llamaindex 0.9.3
File Interpreter ABI Platform
sigil_sdk_llamaindex-0.9.3-py3-none-any.whl Python 3 none any Details

Total release size: 17.6 kB

Release files / sigil_sdk_llamaindex-0.9.3.tar.gz

Download URL sigil_sdk_llamaindex-0.9.3.tar.gz
Size 9.9 kB
Tags Source
SHA-256 checksum
How to use checksums
aaa585a28dabba314ffbbbc9d4a38d8f94705aad2aee3f89d159919fa1c4b17b
BLAKE2b-256 checksum
How to use checksums
4eb4c991d76210e940281de521a5be5b8f6a63811ad2be700e5dfc5c67006d6b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

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 Jul 13, 2026.

Transparency log

Release files / sigil_sdk_llamaindex-0.9.3-py3-none-any.whl

Download URL sigil_sdk_llamaindex-0.9.3-py3-none-any.whl
Size 7.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a8300a20c75f3faece8a13c4d39619602295c78aad0dc123738ff6b31d348153
BLAKE2b-256 checksum
How to use checksums
707fd3b2f02ae46e377012edfe344e11e58d0d679b07549fc2e5c2373efab29a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

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 Jul 13, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.9.3 This release

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

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