Skip to content

Quick Start

This guide walks you through the basic CLI commands to explore the MITRE EMB3D framework.

Explore categories

List the four EMB3D device categories:

uvx mitre-emb3d --pprint list-categories

List properties

View device properties for a category:

uvx mitre-emb3d --pprint list-properties-for-category "Networking"

Include sub-properties up to a given depth:

uvx mitre-emb3d --pprint list-properties-for-category "Networking" --level 3

List threats

See all threats in a category:

uvx mitre-emb3d --pprint list-threats-for-category "Networking"

Or threats related to a specific property:

uvx mitre-emb3d --pprint list-threats-for-property PID-41

Get threat details

View a threat along with its mitigations:

uvx mitre-emb3d --pprint threat TID-221

AI-powered analysis

To run AI analysis on a repository, you need a configuration file:

uvx mitre-emb3d ai --repo ./my-firmware --config config.toml map-properties
uvx mitre-emb3d ai --repo ./my-firmware --config config.toml threat-analysis
uvx mitre-emb3d ai --repo ./my-firmware --config config.toml gen-site

See the AI Commands reference and the Configuration Guide for details.