Quickstart

Install

# Python 3.11+
pip install iamarmor

Optional launchers:

pipx install iamarmor
uvx iamarmor lint .

uvx runs the tool on-demand without installation; pipx installs it in an isolated environment for repeated use.

Run your first scan

iamarmor lint .

Run against a specific path:

iamarmor lint modules/iam/

JSON output for CI and automation:

iamarmor lint . --format json

Add config (optional)

Create .iamarmor.yml at your repo root:

version: 1
severity_threshold: low
fail_on: high
rules:
  ignore: [IAM004]

CI integration

- name: Lint IAM policies
  run: |
    pip install iamarmor
    iamarmor lint . --fail-on high

Next steps

• .iamarmor.yml reference
• Default rule list
• Self-host guide