ChangeLog [hark-lib]
PyHARK 2.1.0 (HARK acoustic library with Python bindings) (Dec. 03, 2026)
(Scheduled to be released at the 25th HARK tutorial)
- NewFeatures
- We offer users the option to obtain PyHARK with pip.
Note: The URL has changed from the Early Access (EA) version—which was available exclusively to HARK tutorial participants and those who purchased the book—to the General Availability (GA) version.
PyHARK Installation instruction for Ver.2.x - PyHARK will also change to allow you to add optional packages (for example, packages like hark-binaural and hark-rescue).
- Added some optional packages with PyHARK.
- We have implemented a support function that allows you to visually analyze data on Jupyter.
- Transfer function creation support feature (HARKTool) has been integrated into PyHARK.
- We offer users the option to obtain PyHARK with pip.
- BugFixes
- KnownIssues
- Notices
In order to use the plotting node used kivy, additional installation of kivy garden graph is required.
Improvements to the wheel package build process have resulted in a change where packages are now automatically retrieved from PyPI.
PyHARK 2.0.1 (HARK 4.0.0) (HARK acoustic library with Python bindings)
(Dec. 02, 2025)
- NewFeatures
- We offer users the option to obtain PyHARK with pip.
- Added some optional packages with PyHARK.
- Improved the visualization features in PyHARK.
- Transfer function creation support feature (HARKTool) has been integrated into PyHARK.
- We have implemented a support function that allows you to visually analyze data on Jupyter.
- BugFixes
- KnownIssues
- Notices
In order to use the plotting node used kivy, additional installation of kivy garden graph is required.
Improvements to the wheel package build process have resulted in a change where packages are now automatically retrieved from PyPI.
PyHARK 2.0.0 (Included in HARK 3.6.0) (HARK acoustic library with Python bindings)
(Nov. 29, 2024)
- NewFeatures
We offer users the option to obtain PyHARK with pip.
As of the time of this notice, the content is currently being prepared due to website-related circumstances.- PyHARK will also change to allow you to add optional packages (for example, packages like hark-binaural and hark-rescue).
- Added some optional packages with PyHARK.
e.g.)hark-lib-gpu: A GPU-based processing module for sound source localization (LocalizeMUSIC), sound source separation (GHDSS), and barge-in processing (SemiBlindICA).hark-modules-dlssl: A module that includes deep learning-based sound source localization processing.
- We have implemented a tool (n2py) that assists in converting existing HARK network files (
*.nfiles) into PyHARK network files (*.pyfiles).
- BugFixes
- KnownIssues
- Notices
- In order to use the plotting node used kivy, additional installation of kivy garden graph is required.
PyHARK 1.1.1 (Included in HARK 3.5.1) (HARK acoustic library with Python bindings) (Nov. 27, 2023)
- NewFeatures
- BugFixes
- Solved the problem where all feature values were 0. (This is a fix for a regression that occurred in 1.1.0.)
- KnownIssues
- Notices
- In order to use the plotting node used kivy, additional installation of kivy garden graph is required.
- Experimental support for wheel package generation for pip installation.
PyHARK 1.1.0 (Included in HARK 3.5.0) (HARK acoustic library with Python bindings) (Nov. 24, 2023)
(Release for HARK tutorial participants : Nov. 17, 2023)
- NewFeatures
- Improved stability of PyHARK (HARK library and Python bindings).
- BugFixes
- Solved the cause of slow offline processing in PyHARK.
- Solved the problem that caused PyHARK to crash during plotting.
- Stopped outputting unnecessary dump messages.
- Minor bug fixes.
- KnownIssues
- Notices
- Starting from this version, we no longer provide pre-built binary packages for Ubuntu 20.04. As notified in the previous version, the pybind11 package that can be installed with apt install is outdated, and it is necessary to manually update pybind11 to 2.6.0 or later. There was a risk of a version mismatch of pybind11 in the environment of those who installed it as a binary package, so we installed pybind11 manually and made it available only to those who built it from the source code. We apologize for the inconvenience, but thank you for your understanding.
- Updated the build system to support the next LTS Ubuntu 24.04 environments: Changes include support for new versions of CMake, debhelper, etc., and support for pyproject.toml for Python modules.
- In order to use the plotting node used kivy, additional installation of kivy garden graph is required.
PyHARK 1.0.0 (Included in HARK 3.4.0) (HARK acoustic library with Python bindings) (Jan. 31, 2023)
- NewFeatures
- Supports installation using pre-built binaries (Debian packages).
- BugFixes
- KnownIssues
- Notices
- To compile Python Binding on Ubuntu 20.04, pybind11 version 2.6.0 or later must be obtained from git or other sources and installed beforehand. pybind11.get_cmake_dir() called by setup.py will only work with pybind11 version 2.6.0 or higher. pybind11 available from apt on Ubuntu 20.04 is 2.4.3 or earlier and must be updated.
- In order to use the plotting node used kivy, additional installation of kivy garden graph is required.
PyHARK 1.0.0 (HARK acoustic library with Python bindings) (Dec. 15, 2022)
(Initial release for the general public)
- NewFeatures
- Released a new feature for using hark modules from Python. The user just calls import hark. It consists of a new HARK acoustic library implementation in C++ called hark-lib and a Python bindings implementation in pybind11.
- Provides user-defined node implementation and network definition method on Python.
- Provides a transparent migration path to embedded devices.
- Users can choose to easily use HARK in Python or have fine-grained control over HARK via a C++ compatible low-level API.
- BugFixes
- Known Issues prior to the public version 1.0.0 have been fixed.
- KnownIssues
- Notices
- To compile Python Binding on Ubuntu 20.04, pybind11 version 2.6.0 or later must be obtained from git or other sources and installed beforehand. pybind11.get_cmake_dir() called by setup.py will only work with pybind11 version 2.6.0 or higher. pybind11 available from apt on Ubuntu 20.04 is 2.4.3 or earlier and must be updated.
- In order to use the plotting node used kivy, additional installation of kivy garden graph is required.
PyHARK 0.9.1 (HARK acoustic library with Python bindings) (Dec. 05, 2022)
- Overview
- This is a pre-provided version for interested parties. Please do not use unless you have a specific reason to do so.
- NewFeatures
- BugFixes
- Minor bug fixes.
- KnownIssues
- GHDSS node sometimes crashes depending on the setting value.
- Giving std::map<std::vector<float> > input to the Synthesize node could result in incorrect results.
- Notices
- To compile Python Binding on Ubuntu 20.04, pybind11 version 2.6.0 or later must be obtained from git or other sources and installed beforehand. pybind11.get_cmake_dir() called by setup.py will only work with pybind11 version 2.6.0 or higher. pybind11 available from apt on Ubuntu 20.04 is 2.4.3 or earlier and must be updated.
- In order to use the plotting node used kivy, additional installation of kivy garden graph is required.
PyHARK 0.9.0 (HARK acoustic library with Python bindings) (Nov. 23, 2022)
(Early Access release for HARK Tutorial participants)
- Overview
- The implementation algorithm for most nodes is based on HARK 3.4.0, although some changes have been made to speed up the process.
- This version implements basic localization, separation, feature extraction, result output, and communication nodes for HARK Tutorial participants.
- For documentation on how to use the HARK acoustic library, please refer to the 21st HARK Tutorial document.
- NewFeatures
- BugFixes
- KnownIssues
- GHDSS node sometimes crashes depending on the setting value.
- Giving std::map<std::vector<float> > input to the Synthesize node could result in incorrect results.
- Notices
- To compile Python Binding on Ubuntu 20.04, pybind11 version 2.6.0 or later must be obtained from git or other sources and installed beforehand. pybind11.get_cmake_dir() called by setup.py will only work with pybind11 version 2.6.0 or higher. pybind11 available from apt on Ubuntu 20.04 is 2.4.3 or earlier and must be updated.
- In order to use the plotting node used kivy, additional installation of kivy garden graph is required.

