---
id: resolve-robotics-uri-py
version: "0.5.1"
license: BSD
license_treatment: permissive
maintenance: active
---

# resolve-robotics-uri-py — Pure python package to solve ROS-style package:// and Gazebo-style model:// URIs in absolute paths.

License: permissive · Maintenance: active · Downloads: 129.4K/mo

## What it is and what it does

resolve-robotics-uri-py is a pure Python utility that converts ROS package:// and Gazebo model:// URIs into absolute filesystem paths. It's designed for robotics workflows where URDF models, configuration files, and other resources are referenced using symbolic package names rather than absolute paths. The package searches for resources across standard ROS and Gazebo directories (via environment variables like AMENT_PREFIX_PATH and GZ_SIM_RESOURCE_PATH) and supports custom search paths through environment variables or function parameters.

The package provides both a Python API and a command-line tool, making it useful in scripts, build pipelines, and interactive robotics development. With no external dependencies beyond Python's standard library, it integrates easily into existing robotics stacks. It supports Python 3.8 through 3.11 and runs on Linux, macOS, and Windows.

Use it for:

- Locate URDF robot model files in ROS packages for simulation or visualization tools like Gazebo.
- Resolve mesh and texture paths embedded in robot description files during model loading.
- Build shell scripts that convert package:// URIs to absolute paths for command-line robotics tools.
- Integrate custom robot model directories into existing ROS/Gazebo workflows without modifying system paths.
- Programmatically find robot configuration and resource files in Python-based robotics applications.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Resolves ROS-style package:// and Gazebo-style model:// URIs to absolute filesystem paths, with support for custom search directories and standard robotics environment variables.

Yes. This is a lightweight, actively maintained utility with zero external dependencies, a permissive license, and a clear use case in robotics development. Install it if you work with ROS or Gazebo models and need to resolve symbolic URIs to filesystem paths. The low friction and recent activity make it a safe choice for robotics projects.

## Install

pip install resolve-robotics-uri-py
uv add resolve-robotics-uri-py
poetry add resolve-robotics-uri-py

## Installing resolve-robotics-uri-py

Before you install: Low friction: pure Python with no runtime dependencies beyond the standard library. Active maintenance with a recent release (49 days old) and a stable repository.

License in practice: BSD license (permissive) imposes no significant restrictions on use, modification, or distribution in most contexts.

Quickstart:

pip install resolve-robotics-uri-py

import resolve_robotics_uri_py

absolute_path = resolve_robotics_uri_py.resolve_robotics_uri(
    "package://iCub/robots/iCubGazeboV2_7/model.urdf"
)

Requires Python 3.9 or later. The URI resolution depends on packages being installed in standard ROS/Gazebo search paths or custom paths specified via environment variables or function parameters.

Verify before relying:

- Whether the package correctly handles all edge cases in URI resolution (e.g., symlinks, relative paths within packages).
- Performance characteristics when searching across many custom package directories.
- Compatibility with non-standard ROS/Gazebo installations or custom package managers.

## Package facts

- License: BSD (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 129.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ROS package URI resolver, Gazebo model path resolution, robotics URI to absolute path, package:// URI resolver, model:// URI resolver, robot resource locator, URDF model path lookup, robotics, ros-gazebo, uri-resolution

[View on SkillFed](https://skillfed.io/packages/resolve-robotics-uri-py) · [View on PyPI](https://pypi.org/project/resolve-robotics-uri-py/)