Skip to content
KitploitKITPLOIT
ToolsExploitsBlog
Log in
Submit
ToolsExploitsBlog
Submit

Hacking, PenTest, and Cybersecurity Tools for Your Security Arsenal!

Kitploit is a directory of hacking, cybersecurity, and pentesting tools. Discover the latest project updates to find vulnerabilities, analyze systems, automate testing, and strengthen your security.

FeedsContactPrivacy© 2026 Kitploit

Tool Directory

Categories

View all categories
Loading categories
FACT_core — Firmware Analysis and Comparison Tool | Kitploit
Tools/GitHubGitHub/fkie-cad/fact_core
Embedded Systems SecurityStatic AnalysisDynamic Analysis (Sandboxing)IoT SecurityVulnerability AnalysisReverse EngineeringForensicsHardware HackingHardware SecurityHardware & IoT SecurityBinary Analysis
1.5k2501482 months agoReviewed by Kitploit
Share
Firmware Analysis
Top in Embedded Systems Security #3
Top in Firmware Analysis #3
Top in Hardware Hacking #19
Top in Hardware & IoT Security #19
Top in Hardware Security #7
Top in IoT Security #3
GitHubfkie-cad/fact_core

FACT_core

Firmware Analysis and Comparison Tool

View RepositoryWebsite
<h1 align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/4524/bbee9a831c270a75ff45e37eeac38aa04fa85b600b7c6eb43025fdfa6f4d6a08.png" alt="FACT logo with magnifying glass as the C" />
  <br/>
  The Firmware Analysis and Comparison Tool (FACT)
</h1>

<div align="center">

  [![codecov](https://codecov.io/gh/fkie-cad/FACT_core/branch/master/graph/badge.svg)](https://codecov.io/gh/fkie-cad/FACT_core)
  [![Codacy Badge](https://app.codacy.com/project/badge/Grade/d3910401cb58498a8c2d00be80092080)](https://www.codacy.com/gh/fkie-cad/FACT_core/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=fkie-cad/FACT_core&amp;utm_campaign=Badge_Grade)
  [![Gitter chat](https://assets.kitploit.com/production/public/readmes/4524/653dd2df51594ac33a30a1ef03d0d1be9e920f8c32097f1f0c3382c68aae26a3.png)](https://gitter.im/FACT_core/community)
  [![CI Build](https://github.com/fkie-cad/FACT_core/actions/workflows/build_ci.yml/badge.svg)](https://github.com/fkie-cad/FACT_core/actions/workflows/build_ci.yml)
  [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

</div>

## Contents

- [Why FACT?](#why-fact)
- [Setup](#setup)
- [Usage](#usage)
- [Documentation](#documentation)
- [Contribute](#contributing)
- [Additional plugins](#additional-plugins)
- [Analysis Import/Export](#analysis-import--export)
- [Presentations](#presentations)
- [Social](#social)
- [Acknowledgments](#acknowledgments)
- [License](#license)

## Why FACT?

Firmware analysis can be used to achieve several interesting goals.
Chief among those are identifying functionality, components and potential security weaknesses in black box firmware.

The Firmware Analysis and Comparison Tool (FACT) is intended to automate as much as possible of the manual firmware
analysis work.
FACT combines a growing set of powerful analyses to create a unified interface that brings the user from an arbitrary
firmware sample to a finished analysis.
Some of the key features of the FACT analysis, is that results are

- browsable
- searchable
- and comparable.

Furthermore, FACT offers multiple ways of navigating and visualizing analysis results and firmware contents for easy accessibility.
The main FACT interface is a html/js/css-based web Interface that can be hosted locally or shared through the network.
In addition, FACT offers a REST-like HTTP API that can be explored with an integrated SwaggerUI.
Some key features of the web interface are:

- Easy visualization of firmware by a file tree rendering of all firmware components.
- Quick navigation of analysis results by observing summaries of results over all firmware components.
- Highlighting of relevant analysis results as tags on top of each page.
- Various download options for firmware and components to jump into advanced analysis.

While FACT is maintained as a research prototype, the project is well tested, includes a baseline of documentation and
offers a multitude of production level features.
We're always looking for feedback and feature requests.

More details and some screenshots can be found on our [project page](https://fkie-cad.github.io/FACT_core/).

## Setup

### Requirements

FACT is designed as a multiprocess application, the more Cores and RAM, the better.

| Minimal          | Recommended       |
|------------------|-------------------|
| 4 Cores          | 16 Cores          |
| 8 GB RAM         | 64 GB RAM         |
| 10 GB disk space | 10* GB disk space |

> [!NOTE]
> About 10 GB required to set up FACT code, container, and binaries.
> Additional space is necessary for storage of unpacked files and analysis results.
> This can be on a separate partition or drive.

### Local Installation

It's principally possible to install FACT on any Linux distribution, but the installer is limited to

- Debian 12/13 or compatible (stable)
- Ubuntu 22.04/24.04/26.04 or compatible (stable)
- Kali (experimental)

Installation on older distributions (e.g. Debian 11 "Bullseye" or Ubuntu 20.04 "Focal") may still work, but is not
considered stable, since these distributions have reached their end of life.

FACT requires Python 3.10–3.14 (should be the default in all supported distributions)

The setup process is mostly automated and wrapped in a single script.
Some features can be selected specifically though.
For a detailed guide on how to install FACT see
[INSTALL.md](https://github.com/fkie-cad/FACT_core/blob/master/INSTALL.md).

> [!IMPORTANT]
> Note that while making extensive use of containers, FACT still contains many dependencies
> (and there is no _uninstall_ provided).
> If you want to keep your system clean, you can try one of the setup options provided in the following.

### Vagrant

We provide monthly and ready-to-use vagrant boxes of our master branch.
[Vagrant](https://www.vagrantup.com/) is an easy and convenient way to get started with FACT without having to install
it on your machine.
Just setup vagrant and import our provided box into VirtualBox.
Our boxes can be found [on the vagrantup website](https://app.vagrantup.com/fact-cad/boxes/FACT-master)!

Check out on how to get started with FACT and vagrant in
our [tutorial](https://github.com/fkie-cad/FACT_core/blob/master/INSTALL.vagrant.md).

### Docker

There is also a dockerized version, but it is currently unmaintained.
(see the [FACT_docker](https://github.com/fkie-cad/FACT_docker) repo for more information).

## Usage

You can start FACT by executing the `start_fact.py` script.
The script detects all installed components automatically.

```sh
src/start_fact.py
```

Afterward, FACT can be accessed on <http://localhost:5000> (default) or <https://localhost> (if FACT is installed with
nginx).

You can shut down the system by pressing <kbd>Ctrl + c</kbd> or by sending a SIGTERM to the `start_fact.py` script.

> [!CAUTION]
> FACT is not intended to be used as a public internet service.
> The web interface is not a hardened application.
> We try to keep security issues limited by applying SecDevOps but FACT may still offer vulnerabilities.
> Make sure to reset all passwords in the fact configuration if planning to host FACT on not-fully trusted networks.

## Documentation

> [!TIP]
> More documentation on how to use FACT can be found on
our [wiki pages](https://github.com/fkie-cad/FACT_core/wiki/).

You can also take a look at [our Sphinx documentation](https://fkie-cad.github.io/FACT_core/).

Information on what FACT is and how it works can also be found in the slides in the
[`docs` folder](https://github.com/fkie-cad/FACT_core/tree/master/docs).

### REST API

FACT provides a REST API. More information can be found on the [wiki page](https://github.com/fkie-cad/FACT_core/wiki/Rest-API).

### User Management

FACT provides an optional basic authentication, role, and user management.
More information can be found on the [wiki page](https://github.com/fkie-cad/FACT_core/wiki/Authentication).

## Contributing

The easiest way to contribute is writing your own plugin.
Our Developer Manual can be found in the [wiki](https://github.com/fkie-cad/FACT_core/wiki/) on GitHub.

## Additional plugins

Currently available additional plugins:

- [Codescanner](https://github.com/fkie-cad/Codescanner_FACT_plugin) (:warning: different license)
    - Classification of segments (e.g. ascii / code / high entropy) in arbitrary binaries
    - Classification of cpu architecture in code segments

## Analysis Import / Export

The script `src/firmware_import_export.py` can be used to export unpacked files and analysis results and import them
into another FACT instance.
The data is stored as a ZIP archive, and this is also the format the script expects during import.
To export files and analysis data of analyzed firmware images, run

```shell
python3 firmware_import_export.py export FW_UID [FW_UID_2 ...] [-o OUTPUT_DIR]
```

> [!NOTE]
> The exported archives can take up significant disk space.
> There is no fixed relation, but it can surpass the size of the original firmware by a factor of 2 - 10.

After this, you can import the exported files with

```shell
python3 firmware_import_export.py import FW.zip [FW_2.zip ...]
```

## Presentations

### BlackHat Arsenal

We've been happy to show FACT in a number of BlackHat Arsenal sessions.

- [![Black Hat Arsenal](https://raw.githubusercontent.com/toolswatch/badges/master/arsenal/asia/2018.svg)](http://www.toolswatch.org/2018/01/black-hat-arsenal-asia-2018-great-lineup/)
- [![Black Hat Arsenal](https://raw.githubusercontent.com/toolswatch/badges/master/arsenal/europe/2018.svg)](http://www.toolswatch.org/2018/09/black-hat-arsenal-europe-2018-lineup-announced/)
- [![Black Hat Arsenal](https://raw.githubusercontent.com/toolswatch/badges/master/arsenal/usa/2019.svg)](http://www.toolswatch.org/2019/05/amazing-black-hat-arsenal-usa-2019-lineup-announced/)
- [![Black Hat Arsenal](https://raw.githubusercontent.com/toolswatch/badges/master/arsenal/europe/2019.svg)](https://www.blackhat.com/eu-19/arsenal/schedule/#fact--firmware-analysis-and-comparison-tool-18179)
- [![Black Hat Arsenal](https://raw.githubusercontent.com/toolswatch/badges/master/arsenal/usa/2022.svg)](https://www.blackhat.com/us-22/arsenal/schedule/#fact--26776)

### Other

- [Hardwear.io 2017](https://hardwear.io/the-hague-2017/speakers/johannes-vom-dorp.php) / [Slides](https://hardwear.io/document/hio.pdf)
- [Pass the salt 2019](https://2019.pass-the-salt.org/talks/71.html) /
  [Slides](https://2019.pass-the-salt.org/files/slides/04-FACT.pdf) /
  [Video](https://passthesalt.ubicast.tv/videos/improving-your-firmware-security-analysis-process-with-fact/)
- [Hardwear.io 2019](https://hardwear.io/netherlands-2019/speakers/johannes-vom-dorp-and-peter-weidenbach.php)

## Social

- [Twitter](https://twitter.com/FAandCTool)
- [Gitter](https://app.gitter.im/?updated=1.11.30#/room/#FACT_core_community:gitter.im)

## Acknowledgments

Thanks to @botlabsDev, who initially provided a [Vagrantfile](https://github.com/botlabsDev/FACTbox) that is now,
however, deprecated.

This project is partly financed by [German Federal Office for Information Security (BSI)](https://www.bsi.bund.de) and
others.

## License

> Firmware Analysis and Comparison Tool (FACT)
>
> Copyright (C) 2015-2026 Fraunhofer FKIE
>
> This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public
> License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any
> later version.
> This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
> warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  
> See the GNU General Public License for more details.
> You should have received a copy of the GNU General Public License along with this program.  
> If not, see <http://www.gnu.org/licenses/>.
>
> Some plugins may have different licenses.
> If so, a license file is provided in the plugin's folder.
Download Tool

Most Popular

View all →

Discover the most used tools by our community.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 The ultimate OSINT toolkit: investigation graph, confidence scoring, alias families, map, timeline and reports. 49 modules, 400+ sites, no API keys required.

    1.0k
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock One-Tap Execution App (CVE-2026-43499)

    645
  • 3

    looking-glass

    anonghosty/looking-glass

    CSIRT platform that ingests Shadowserver reports into MongoDB and replays them as interactive maps, analysis, findings, advisories and executive dashboards.

    420
  • 4

    jumpserver

    jumpserver/jumpserver

    JumpServer is an open-source Privileged Access Management (PAM) platform that provides DevOps and IT teams with on-demand and secure access to SSH, RDP, Kubernetes, Database and RemoteApp endpoints through a web browser.

    388
  • 5

    ARTEX

    baarai/artex

    LLM multi-agent autonomous penetration testing platform with planner/worker agents, asset and exploration graphs, MITM traffic recording, and vulnerability retesting.

    330
  • 6

    SafeLine

    chaitin/safeline

    Self-hosted WAF and reverse proxy that filters malicious HTTP traffic, blocks SQL injection, XSS, and bot attacks, with rate limiting and dynamic HTML/JS encryption.

    328

Explore all tools

Browse our collection of tools

View all tools →