Setup

This page describes the prerequisites for the sap-iac CLI and the supported ways to install it.

Prerequisites

Dependency	When you need it	Notes
AI agent	Always	Claude Code, Codex, Cursor, or GitHub Copilot. The agent runs the generated `sap-iac.*` commands.
Terraform	Recommended	The generation skill invokes the `terraform` CLI to initialise, format, and validate generated configuration. The resulting HCL may also be used with OpenTofu, but the automated generation workflow currently calls Terraform.
Git	Optional	When present, `init` initialises a repository in the new project automatically.

Missing Terraform or Git is not blocking

sap-iac init does not hard-fail when Terraform or Git is missing. It surfaces a warning and continues, so you can scaffold first and install them when convenient.

Install

Package Manager

Commands

WindowsMac OSLinux

We have submitted the package to be released via winget. Once it is available you can install it using the command below. Please refer to the official Winget documentation websites for details.

winget install SAP.sap-iac

Until it is officially available you can use a install script in this repository as a workaround to install the tool on your Windows machine. Open PowerShell and run the install script:

iwr -useb https://raw.githubusercontent.com/SAP/iac-spec-kit-for-sap-business-ai-platform/refs/heads/main/sap-iac-install.ps1 | iex

Please refer to the Homebrew website for details.

brew tap SAP/iac-spec-kit-for-sap-business-ai-platform https://github.com/SAP/iac-spec-kit-for-sap-business-ai-platform
brew install sap/iac-spec-kit-for-sap-business-ai-platform/sap-iac

We’ve released deb and rpm packages to support installation on the most common Linux distributions. You can download the packages from the assets section of the releases page.

For Debian-based distributions (like Ubuntu, Linux Mint, etc.):

sudo dpkg -i <path-to-download>/iac-spec-kit-for-sap-business-ai-platform_<latest-version>_linux_amd64.deb

For RPM-based distributions (like Fedora, RHEL, CentOS, openSUSE):

sudo rpm -i <path-to-download>/iac-spec-kit-for-sap-business-ai-platform_<latest-version>_linux_amd64.rpm

Download Binaries

You can download the binaries directly from the releases section of the GitHub repository.

Select the version that you want to use and download the binary that fits your operating system from the assets of the release. We recommend using the latest version.

Local Build

git clone https://github.com/SAP/iac-spec-kit-for-sap-business-ai-platform.git
cd iac-spec-kit-for-sap-business-ai-platform
go build -o sap-iac ./cmd/sap-iac

This produces a sap-iac binary in the current directory. Move it onto your PATH (for example, mv sap-iac /usr/local/bin/) to run it from anywhere.

Install with Go

go install github.com/SAP/iac-spec-kit-for-sap-business-ai-platform/cmd/sap-iac@latest

The binary is installed to $(go env GOBIN), or $(go env GOPATH)/bin if GOBIN is unset.

Tip

Ensure the install directory is on your PATH, otherwise your shell will not find the sap-iac command.

Make targets

From a source checkout, the Makefile wraps the common tasks:

Target	Action
`make build`	Compile the CLI (`go build -v ./...`).
`make install`	Build and install all commands (`go install ./...`)
`make test`	Run the test suite.
`make lint`	Run `golangci-lint`.
`make fmt`	Format the code with `gofmt`.

Verify

Confirm the CLI is installed and runnable:

sap-iac --help

Continue to Usage.