A Python SDK that enables developers to build and deploy Google ADK agents to the UiPath Cloud Platform. It provides programmatic interaction with UiPath Cloud Platform services.

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.

• Python 3.11 or higher
• UiPath Automation Cloud account

pip install uipath-google-adk

using uv:

uv add uipath-google-adk

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

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

uipath auth

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

uipath init

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

uipath run AGENT [INPUT]

Executes the agent with the provided JSON input arguments.

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]"}]

uipath publish

Publishes the most recently created package to your UiPath Orchestrator.

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

• A pyproject.toml file with project metadata
• A google_adk.json file with your agent definitions (e.g., "agents": {"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

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

Please read our contribution guidelines before submitting a pull request.

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

• Google ADK for providing a powerful framework for building AI agents.
• OpenInference for observability and instrumentation support.
• Pydantic for reliable, typed configuration and validation.