UiPath LlamaIndex Python SDK

A Python SDK that enables developers to build and deploy LlamaIndex agents to the UiPath Cloud Platform. It provides programmatic interaction with UiPath Cloud Platform services and human-in-the-loop (HITL) semantics through Action Center integration.

This package is an extension to the UiPath Python SDK and implements the UiPath Runtime Protocol.

Check out these sample projects to see the SDK in action.

Requirements

• Python 3.11 or higher
• UiPath Automation Cloud account

Installation

pip install uipath-llamaindex

using uv:

uv add uipath-llamaindex

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

Command Line Interface (CLI)

The SDK provides a command-line interface for creating, packaging, and deploying LlamaIndex Agents:

Initialize a Project

uipath init

Running uipath init will process the workflow definitions in the llama_index.json file and create the corresponding entry-points.json file needed for deployment.

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

Authentication

uipath auth

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

Debug a Project

uipath run WORKFLOW [INPUT]

Executes the agent 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 = "[email protected]"}]

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 llama_index.json file with your workflow definitions (e.g., "workflows": {"agent": "main.py:agent"})
• 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

Developer Tools

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

Setting Up a Development Environment

Please read our contribution guidelines before submitting a pull request.

Special Thanks

A huge thank-you to the open-source community and the maintainers of the libraries that make this project possible:

• LlamaIndex for providing a powerful framework for building stateful LLM applications.
• OpenInference for observability and instrumentation support.
• Pydantic for reliable, typed configuration and validation.