rospkg
ROS package library
What it is and what it does
rospkg is a standalone Python library that lets you interact with the ROS package system without needing a full ROS installation. It handles ROS package metadata, filesystem lookups, and package discovery by parsing package.xml files and navigating the ROS package directory structure. The library depends on catkin-pkg for core package handling, PyYAML for manifest parsing, and distro for system information.
Typical use is in tools, scripts, or applications that need to query ROS package information, locate packages on disk, or inspect package metadata programmatically. It's useful when you want ROS package introspection capabilities in a lightweight, standalone context rather than within a full ROS environment.
Use it for:
- Query ROS package metadata and dependencies from Python without a full ROS installation
- Locate ROS packages on the filesystem and inspect their package.xml manifests
- Build tools or scripts that need to understand ROS package structure and organization
- Integrate ROS package discovery into CI/CD pipelines or build systems
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides Python access to ROS package metadata and filesystem operations without requiring a full ROS installation.
Yes, if you need ROS package introspection in Python outside a full ROS environment. The low install friction, permissive license, and active repository make it a safe choice. No known vulnerabilities. Install it if your workflow involves ROS packages and you want programmatic access to their metadata.
Install
rospkg on PyPI
pip
pip install rospkguv
uv add rospkgpoetry
poetry add rospkgInstalling rospkg
Before you install
Low friction install with three runtime dependencies. Maintenance status is aging—last commit was 2025-12-18 and the package has been released since 2011-08-18, but the repository remains active and not archived.
License in practice
BSD license is permissive; you can use this package in commercial and proprietary projects with minimal restrictions, provided you retain the license notice.
Quickstart
pip install rospkg
import rospkg
rospack = rospkg.RosPack()
package_path = rospack.get_path('package_name')
Requires Python >=3.6
Verify before relying
- Whether this package works standalone or requires a ROS environment to be present on the system
- Scope of ROS package operations supported (e.g., dependency resolution, manifest parsing, package discovery limits)
Package facts
| License | BSD (permissive) |
| Python support | supports the current Python release (>=3.6) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 3 — catkin-pkg, PyYAML, distro |
| Maintenance | aging — 238 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 514,004/month — #6,241 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: rospkg-1.6.1-py3-none-any.whl
Keywords: ROS
Tags
More Software Development packages
Provides backported and experimental type hints…
permissive · top 100 on PyPI
numpyNumPy provides an N-dimensional array object…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
annotated-docProvides a way to document function parameters,…
permissive · top 100 on PyPI
typerTyper builds command-line applications from…
permissive · top 1,000 on PyPI
distlibDistlib provides low-level packaging utilities…
permissive · top 1,000 on PyPI
rosbagsRead, write, convert, and deserialize ROS bag…
permissive · top 15,000 on PyPI
rosdistroParses and manipulates ROS distribution…
permissive · top 15,000 on PyPI
colcon-rosExtends colcon to recognize and build ROS…
permissive · top 15,000 on PyPI
catkin-pkgParses and manages Catkin package metadata and…
permissive · top 5,000 on PyPI
pyros-genmsgGenerates ROS message and service data…
permissive · top 15,000 on PyPI
resolve-robotics-uri-pyResolves ROS-style package:// and Gazebo-style…
permissive · top 15,000 on PyPI
pkgconfpkgconf is a cross-platform Python package that…
permissive · top 15,000 on PyPI
cmeel-console-bridgeProvides a Python distribution of…
permissive · top 15,000 on PyPI
colcon-common-extensionsBundles colcon-core and twenty common colcon…
permissive · top 15,000 on PyPI