parlot-core

Shared semantic conventions, base span processor, and utilities for Parlot instrumentation packages — the MIT foundation behind Parlot production voice AI observability.

Install parlot-instrumentation-livekit (or parlot[livekit]) in agent code. This package is pulled in as a dependency; it is not the public parlotize() entrypoint.

parlot.core.attrs — GenAI semconv v1.41 pin, Conversation Contract / GenAI / voice span names, ATTR_* constants; TypeScript mirror in @parlot/core (packages/core-ts, run uv run python scripts/generate_attrs_ts.py after edits). Pin surface: packages/core/genai_semconv.lock.json (bump lock with GENAI_SEMCONV_VERSION)
parlot.core.export — shared ExportFilterSpanExporter (contract ∪ GenAI ∪ voice allowlist)
parlot.core.parlotize — ParlotizeProtocol (keyword-only shared kwargs)
parlot.core.session — SessionState, get_active_session() / session_owned() for cross-package coexistence
parlot.core.provider — shared endpoint/api_key resolve + TracerProvider/OTLP bootstrap helpers
parlot.core.bootstrap — GET /v1/telemetry/bootstrap → ParlotRuntimeContext
parlot.core.genai_content_capture — should_capture_genai_content (generative AI / tool bodies; see Concepts)
parlot.core.processor — ParlotBaseProcessor(SpanProcessor) with shared span-mutation helpers
parlot.core.platform_refs — generic stamp_platform_refs() for platform.ref.* triples

Not for direct use

This package is a dependency of instrumentation packages (parlot-instrumentation-livekit, parlot-instrumentation-langgraph, etc.). Import from those packages in your agent code, not from here directly.

Docs: parlot.ai/docs · GitHub

Metadata

Release files for parlot-core 0.4.0

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

Source distribution (sdist)

Source distribution for parlot-core 0.4.0
File	Size	Uploaded	Provenance
parlot_core-0.4.0.tar.gz	28.7 kB	Sep 14, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for parlot-core 0.4.0
File	Interpreter	ABI	Platform	Reset
parlot_core-0.4.0-py3-none-any.whl 38.9 kB Sep 14, 2026 With provenance	Python 3	none	any	Details

Total release size: 67.6 kB

Release files / parlot_core-0.4.0.tar.gz

Download URL	parlot_core-0.4.0.tar.gz
Size	28.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`bb3ff46a82ae328a920e69c657c7bd74e57216724c6c13e0d23adedd12307c73`
BLAKE2b-256 checksum How to use checksums	`c33065ce61527db6d8194b5464f3c3772368dbbc673e0f743d9d41319a8ae5cf`
Upload date	Sep 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/parlot-ai/sdk
Publishing commit: github.com/parlot-ai/sdk/tree/34b9e0340bc435010d9d6fdc2dc8899c6f5ada2c

Workflow

Publishing configuration: github.com/parlot-ai/sdk/blob/34b9e0340bc435010d9d6fdc2dc8899c6f5ada2c/.github/workflows/publish.yml
Publishing logs: github.com/parlot-ai/sdk/actions/runs/34848583493/attempts/1

Artifact

Subject: parlot_core-0.4.0.tar.gz
SHA-256 checksum: bb3ff46a82ae328a920e69c657c7bd74e57216724c6c13e0d23adedd12307c73 Verifying attestations

Release files / parlot_core-0.4.0-py3-none-any.whl

Download URL	parlot_core-0.4.0-py3-none-any.whl
Size	38.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`da3a7e21d6eb6e6ba2a1f31d1b66303d61d5629f75ed4806f57dd81fba1908af`
BLAKE2b-256 checksum How to use checksums	`798e39d31da5153de9de751a4126513e428bb5345dd321a4969631c78472e469`
Upload date	Sep 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/parlot-ai/sdk
Publishing commit: github.com/parlot-ai/sdk/tree/34b9e0340bc435010d9d6fdc2dc8899c6f5ada2c

Workflow

Publishing configuration: github.com/parlot-ai/sdk/blob/34b9e0340bc435010d9d6fdc2dc8899c6f5ada2c/.github/workflows/publish.yml
Publishing logs: github.com/parlot-ai/sdk/actions/runs/34848583493/attempts/1

Artifact

Subject: parlot_core-0.4.0-py3-none-any.whl
SHA-256 checksum: da3a7e21d6eb6e6ba2a1f31d1b66303d61d5629f75ed4806f57dd81fba1908af Verifying attestations

Security for parlot-core 0.4.0

Report project as malware

Provenance

Full provenance

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

Attestation for parlot_core-0.4.0.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/parlot-ai/sdk
Publishing commit: github.com/parlot-ai/sdk/tree/34b9e0340bc435010d9d6fdc2dc8899c6f5ada2c

Workflow

Publishing configuration: github.com/parlot-ai/sdk/blob/34b9e0340bc435010d9d6fdc2dc8899c6f5ada2c/.github/workflows/publish.yml
Publishing logs: github.com/parlot-ai/sdk/actions/runs/34848583493/attempts/1

Artifact

Subject: parlot_core-0.4.0.tar.gz
SHA-256 checksum: bb3ff46a82ae328a920e69c657c7bd74e57216724c6c13e0d23adedd12307c73 Verifying attestations

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.