Skip to content

Linux & macOS Installation

Prerequisites

  • Python >= 3.8
  • pip (included with Python)
python3 --version

Install ThothCTL

pip install thothctl

Verify:

thothctl --version

System Dependencies

Graphviz (required for dependency graphs)

sudo apt install graphviz -y

sudo dnf install graphviz -y

brew install graphviz

Optional Tools

Install based on your use case:

Tool Purpose Install
Terraform / OpenTofu IaC provisioning terraform.io / opentofu.org
Terragrunt IaC orchestration terragrunt.gruntwork.io
Checkov Security scanning pip install checkov
Trivy Vulnerability scanning trivy.dev
KICS IaC security (Docker) docker pull checkmarx/kics:latest
Terraform-docs Module documentation terraform-docs.io

Shell Autocomplete

thothctl-register-autocomplete

This detects your shell (Bash, Zsh, or Fish) and configures completion automatically.

Manual Setup

echo 'eval "$(_THOTHCTL_COMPLETE=bash_source thothctl)"' >> ~/.bashrc
source ~/.bashrc

echo 'eval "$(_THOTHCTL_COMPLETE=zsh_source thothctl)"' >> ~/.zshrc
source ~/.zshrc

echo '_THOTHCTL_COMPLETE=fish_source thothctl | source' >> ~/.config/fish/config.fish

Development Install

git clone https://github.com/thothforge/thothctl.git
cd thothctl
pip install -e .

Next Steps