Skip to content

libhri

  • Software
  • Perception
  • Library

A helper library for the ROS4HRI framework that makes it easier to read a robot's perception of nearby humans, in C++ and Python.

Made by ROS4HRI.

Source on GitHub: github.com/ros4hri/libhri (opens in a new tab). Facts read at commit 3687094 (opens in a new tab).

Licenses

Code
Apache-2.0 (opens in a new tab)

Read by Robotheca from LICENSE (opens in a new tab) (Apache-2.0) at commit 3687094 (opens in a new tab), on 16 Oct 2026.

Commercial use
Yes

What it does

  • Wraps ROS4HRI human perception topics behind a simpler API.
  • Provides the hri C++ package and the pyhri Python package, which wraps the C++ one with Pybind11.
  • HRIListener is the main entry point for using the library.
  • Python documentation is available through help() after importing hri.
  • Includes an example program in both C++ and Python.
  • This repository covers ROS 2 only; ROS 1 support lives on another branch.

Written by Robotheca from the project's README (opens in a new tab) at commit 3687094.

Getting started

Difficulty
Intermediate

Maintenance

Status
Active: a commit in the last 90 days
Newest commit
25 Aug 2026 on humble-devel
Latest release
ROS 2 port (19 Dec 2023)

Checked on GitHub on 16 Oct 2026.

Robots that can run it

No robot on Robotheca is linked to it yet. Links come from a robot's robot.yaml, from its dependency files read as text, or from Robotheca's editors.

Robotheca lists software as a reference: nothing is hosted or run here, and every fact links to where it was read.