A Python SDK that enables developers to build and deploy LangGraph 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.

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

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-langchain

using uv:

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 LangGraph Agents:

Initialize a Project

Running uipath init will process the graph definitions in the langgraph.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

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

Debug a Project

Executes the agent with the provided JSON input arguments.

Package a Project

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

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 langgraph.json file with your graph definitions (e.g., "graphs": {"agent": "graph.py:graph"})
• 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:

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