Skip to main content

UiPath Python SDK

PyPI downloads PyPI - Version Python versions

A Python SDK that enables programmatic interaction with UiPath Cloud Platform services including processes, assets, buckets, context grounding, data services, jobs, and more. The package also features a CLI for creation, packaging, and deployment of automations to UiPath Cloud Platform.

Use the UiPath LangChain SDK to pack and publish LangGraph Agents.

Check out other UiPath Integrations to pack and publish agents built with LlamaIndex, OpenAI Agents, Google ADK, and more.

This quickstart guide walks you through deploying your first agent to UiPath Cloud Platform.

Table of Contents

Installation

pip install uipath

using uv:

uv add uipath

Configuration

Environment Variables

Create a .env file in your project root with the following variables:

UIPATH_URL=https://cloud.uipath.com/ACCOUNT_NAME/TENANT_NAME
UIPATH_ACCESS_TOKEN=YOUR_TOKEN_HERE

Basic Usage

from uipath.platform import UiPath
# Initialize the SDK
sdk = UiPath()
# Execute a process
job = sdk.processes.invoke(
    name="MyProcess",
    input_arguments={"param1": "value1", "param2": 42}
)
# Work with assets
asset = sdk.assets.retrieve(name="MyAsset")

Available Services

The SDK provides access to various UiPath services:

  • sdk.processes - Manage and execute UiPath automation processes

  • sdk.assets - Work with assets (variables, credentials) stored in UiPath

  • sdk.buckets - Manage cloud storage containers for automation files

  • sdk.connections - Handle connections to external systems

  • sdk.context_grounding - Work with semantic contexts for AI-enabled automation

  • sdk.jobs - Monitor and manage automation jobs

  • sdk.queues - Work with transaction queues

  • sdk.tasks - Work with Action Center

  • sdk.api_client - Direct access to the API client for custom requests

Examples

Buckets Service

# Download a file from a bucket
sdk.buckets.download(
    bucket_key="my-bucket",
    blob_file_path="path/to/file.xlsx",
    destination_path="local/path/file.xlsx"
)

Context Grounding Service

# Search for contextual information
results = sdk.context_grounding.search(
    name="my-knowledge-index",
    query="How do I process an invoice?",
    number_of_results=5
)

Command Line Interface (CLI)

The SDK also provides a command-line interface for creating, packaging, and deploying automations:

Authentication

uipath auth

This command opens a browser for authentication and creates/updates your .env file with the proper credentials.

Initialize a Project

uipath init

The uipath.json file should include your entry points in the functions section:

{
  "functions": {
    "main": "main.py:main"
  }
}

Running uipath init will process these function definitions and create the corresponding entry-points.json file needed for deployment.

For more details on the configuration format, see the UiPath configuration specifications.

Debug a Project

uipath run ENTRYPOINT [INPUT]

Executes a Python script with the provided JSON input arguments.

Package a Project

uipath pack

Packages your project into a .nupkg file that can be deployed to UiPath.

Note: Your pyproject.toml must include:

  • A description field (avoid characters: &, <, >, ", ', ;)
  • Author information

Example:

description = "Your package description"
authors = [{name = "Your Name", email = "your.email@example.com"}]

Publish a Package

uipath publish

Publishes the most recently created package to your UiPath Orchestrator.

Project Structure

To properly use the CLI for packaging and publishing, your project should include:

  • A pyproject.toml file with project metadata
  • A uipath.json file with your function definitions (e.g., "functions": {"main": "main.py:main"})
  • A entry-points.json file (generated by uipath init)
  • A bindings.json file (generated by uipath init) to configure resource overrides
  • Any Python files needed for your automation

Development

Tools

Check out uipath-dev - an interactive application for building, testing, and debugging UiPath Python runtimes, agents, and automation scripts.

Contributions

Please read our contribution guidelines before submitting a pull request.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

uipath-2.11.19.tar.gz (4.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

uipath-2.11.19-py3-none-any.whl (408.3 kB view details)

Uploaded Python 3

File details

Details for the file uipath-2.11.19.tar.gz.

File metadata

  • Download URL: uipath-2.11.19.tar.gz
  • Upload date:
  • Size: 4.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for uipath-2.11.19.tar.gz
Algorithm Hash digest
SHA256 98bdc434afc9a671e82a59e79cb6d62ebc39ea6ef96baa633d9e852ebcf9c80c
MD5 e5b3788a5cba157090d6af7ba13655a1
BLAKE2b-256 758fef00ea678479a9873ba16bb47b37a3479b17697e5efcaa96ba734849ea08

See more details on using hashes here.

Provenance

The following attestation bundles were made for uipath-2.11.19.tar.gz:

Publisher: cd.yml on UiPath/uipath-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file uipath-2.11.19-py3-none-any.whl.

File metadata

  • Download URL: uipath-2.11.19-py3-none-any.whl
  • Upload date:
  • Size: 408.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for uipath-2.11.19-py3-none-any.whl
Algorithm Hash digest
SHA256 176e5d17e66ea3771edbb48dfaeb2875a9d205e27cfe4e6fec3da0d6338e89a7
MD5 106726138c5f4a20fd04869ad7b9cd3f
BLAKE2b-256 c3c80493ab47adcffde83e6fad864ed879533bf9af3111fcb3d981da100d0365

See more details on using hashes here.

Provenance

The following attestation bundles were made for uipath-2.11.19-py3-none-any.whl:

Publisher: cd.yml on UiPath/uipath-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page