After three years in beta, we’re excited to announce that thehive4py 2.0, the official Python TheHive’s API Client, will be available as a stable release starting August 1st, 2025.
This version replaces the legacy 1.8 release, which was originally developed for TheHive 3 and built on the now-obsolete v0 API.
A brief history of thehive4py
thehive4py is a Python module that wraps TheHive’s public APIs, making it easier to build integrations and custom connectors using the Python language.
The original 1.x version (the latest release being 1.8.2) was designed for TheHive 3 and built on APIs v0 and has been updated to support TheHive 4 and maintain backward compatibility.
In contrast, thehive4py 2.0 is optimised for TheHive 5, leveraging the modern and fully documented v1 API.
Version 2.0 has been available in beta since August 2022, and we’ve worked closely with the community to ensure it’s production-ready. (Special thanks to Kamforka for his invaluable contributions to improving the library).
We waited to release thehive4py 2.0 GA until the v1 API of TheHive was complete, stable, and fully capable—a milestone we’ve now reached. This new version is a full rewrite of the library, built to align with the modern API and offer a cleaner, more robust integration experience.
To avoid disrupting existing users, we kept 2.0 in beta longer than usual. Now that it’s proven mature and reliable, it’s the right time to make it the default choice for Python-based integrations with TheHive.
Still using thehive4py 1.x?
No stress! If you’ve built scripts or tools using the legacy 1.x version, you’re not forced to migrate immediately. You can still pin that version in your requirements.txt file:
That said, as v1.x is no longer maintained, we strongly encourage you to switch to thehive4py 2.0 to take full advantage of the latest features and future updates.
For more details, check out the GitHub project.
Thank you to the community!
As an open source library, thehive4py 2.0 isn’t just the product of our internal work, it’s the result of contributions from a passionate and engaged community.
So thank you to all the maintainers, testers, bug reporters, and early adopters who helped shape this release. Your feedback made a real impact.
Whether you want to automate incident workflows, build custom connectors, or just get your hands dirty, thehive4py 2.0 is ready.
Now’s the perfect time to explore it!
Get started, contribute, or star the project here: