UiPath Core

Core abstractions and contracts for the UiPath Python SDK.

Installation

pip install uipath-core

Modules

Errors

Exception hierarchy for UiPath trigger errors with category-based classification.

ErrorCategory: Enum: DEPLOYMENT, SYSTEM, UNKNOWN, USER
UiPathFaultedTriggerError: Base trigger error with category and detail
UiPathPendingTriggerError: Pending trigger variant

from uipath.core.errors import ErrorCategory, UiPathFaultedTriggerError

Serialization

JSON serialization utilities for complex Python types. Handles Pydantic models (v1 & v2), dataclasses, enums, datetime/timezone objects, sets, tuples, and named tuples.

serialize_json(obj): Serialize any object to a JSON string
serialize_defaults(obj): Custom default handler for json.dumps()

from uipath.core.serialization import serialize_json

Tracing

OpenTelemetry integration with UiPath execution tracking. Provides function instrumentation, span lifecycle management, custom exporters, and batch/simple span processors with automatic execution.id propagation.

@traced: Decorator for sync/async function instrumentation. Supports custom span names, run types, input/output processors, and non-recording spans
UiPathTraceManager: Manages TracerProvider, span exporters, and processors. Provides start_execution_span() context manager and span retrieval by execution ID
UiPathSpanUtils: Span registry and parent context management
UiPathTraceSettings: Configuration model with optional span filtering

from uipath.core.tracing import traced, UiPathTraceManager

@traced(name="my_operation", run_type="tool")
def do_work(input: str) -> str:
    return process(input)

Guardrails

Deterministic rule-based validation for inputs and outputs. Rules are evaluated pre-execution (input-only) and post-execution (all rules), with flexible field selection using dot-notation paths and array access ([*]).

Rule types:

WordRule: String pattern matching
NumberRule: Numeric constraint validation
BooleanRule: Boolean assertions
UniversalRule: Always-apply constraints

Field selection:

AllFieldsSelector: Apply to all fields of a given source (input/output)
SpecificFieldsSelector: Target specific fields by path

Service:

DeterministicGuardrailsService: Evaluates guardrail rules against inputs/outputs, returning GuardrailValidationResult with pass/fail status and reason

from uipath.core.guardrails import DeterministicGuardrailsService, GuardrailValidationResultType

Chat

Pydantic models for the UiPath conversation event protocol. Defines the streaming event schema between clients and LLM/agent backends.

Hierarchy:

Conversation → Exchange → Message → Content Parts (with Citations)
                                  → Tool Calls (with Results)
                                  → Interrupts (human-in-the-loop)

Supports session capabilities negotiation, async input streams (audio/video), tool call confirmation interrupts, URL and media citations, and inline/external value references.

from uipath.core.chat import UiPathConversationEvent, UiPathSessionStartEvent

Dependencies

Package	Version
`pydantic`	`>=2.12.5, <3`
`opentelemetry-sdk`	`>=1.39.0, <2`
`opentelemetry-instrumentation`	`>=0.60b0, <1`

Metadata

Release files for uipath-core 0.5.33

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

Source distribution (sdist)

Source distribution for uipath-core 0.5.33
File	Size	Uploaded
uipath_core-0.5.33.tar.gz	131.3 kB	Oct 6, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for uipath-core 0.5.33
File	Interpreter	ABI	Platform	Reset
uipath_core-0.5.33-py3-none-any.whl 55.1 kB Oct 6, 2026	Python 3	none	any	Details

Total release size: 186.4 kB

Release files / uipath_core-0.5.33.tar.gz

Download URL	uipath_core-0.5.33.tar.gz
Size	131.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`f533a3145131ce93bde78a264f98a796134dcd7a6ebf3211d8247a49d3b3eebc`
BLAKE2b-256 checksum How to use checksums	`c6328a254ae086cfa0ca9808d36b9084cffeea151b4250e77e84eed8c9dcde17`
Upload date	Oct 6, 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/UiPath/uipath-python
Publishing commit: github.com/UiPath/uipath-python/tree/ae20e9a468dc0206ad17728e024341e32765a20f

Workflow

Publishing configuration: github.com/UiPath/uipath-python/blob/ae20e9a468dc0206ad17728e024341e32765a20f/.github/workflows/cd.yml
Publishing logs: github.com/UiPath/uipath-python/actions/runs/37520427768/attempts/1

Artifact

Subject: uipath_core-0.5.33.tar.gz
SHA-256 checksum: f533a3145131ce93bde78a264f98a796134dcd7a6ebf3211d8247a49d3b3eebc Verifying attestations

Release files / uipath_core-0.5.33-py3-none-any.whl

Download URL	uipath_core-0.5.33-py3-none-any.whl
Size	55.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`13c541c9b684e3f7556c830442b9fa48a3a42a36a38a3086195b10eeb4360ffb`
BLAKE2b-256 checksum How to use checksums	`7a153aa01f0011515c0508e966eabf6b0949d61d8c2c326cf83f943616733ec3`
Upload date	Oct 6, 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/UiPath/uipath-python
Publishing commit: github.com/UiPath/uipath-python/tree/ae20e9a468dc0206ad17728e024341e32765a20f

Workflow

Publishing configuration: github.com/UiPath/uipath-python/blob/ae20e9a468dc0206ad17728e024341e32765a20f/.github/workflows/cd.yml
Publishing logs: github.com/UiPath/uipath-python/actions/runs/37520427768/attempts/1

Artifact

Subject: uipath_core-0.5.33-py3-none-any.whl
SHA-256 checksum: 13c541c9b684e3f7556c830442b9fa48a3a42a36a38a3086195b10eeb4360ffb Verifying attestations