Repository files navigation

Pyrrha is a filesystem cartography and correlation software focusing on visualization. It currently focuses on the relationship between executable files but aims at enabling anyone to map and visualize any relationship types. It uses the open-source code sourceexplorerNumbatUI to provide users with an easy way to navigate through and search forpath to function.

An example of the symbols and libraries imported bylibgcc_s.so.1 and of the symbols which reference this library.

An example of the symlinks which point onbusybox.

The installation is done in three parts:

1. Install mapper external dependencies: IDA dissassembler (with the decompilation option for theexe-decomp mapper) andQuokka IDA plugin.
2. InstallPyrrha itself.
3. InstallNumbatUI (orSourcetrail) to be able to visualize Pyrrha's results.

The usage workflow is composed of two steps which allow you to separate DB creation and result visualization.

1. Run Pyrrha to obtain NumbatUI compatible files (*.srctrlprj for the project file and*.srctrldb for the DB file). With the python package, you can just launch the commandpyrrha.
2. Visualize your results with Sourcetrail/NumbatUI.

Pyrrha presentations, including live demos:

• Pyrrha & Friends: Diving into Firmware Cartography, Eloïse Brocas & Robin Davis,SSTIC, Rennes, France, 2025.[slides][video]

• Pyrrha: navigate easily into your system binaries, Eloïse Brocas,Hack.lu, Luxembourg, 2023.[slides][video]

• Map your Firmware!, Eloïse Brocas,Pass The SALT, Lille, France, 2023.[slides][video]

Theory behind implementations

• Streamlining Firmware Analysis with Inter-Image Call Graphs and Decompilation, Robin David,RE//verse.io, USA, 2025.[slides][video]

• Eloïse Brocas (@ebrocas), Quarkslab
• Robin David (@RobinDavid), Quarkslab

• Pascal Wu (@pwu42), during his internship at Quarkslab