AI-powered Infrastructure as Code assistant for cloud infrastructure through natural language interaction. Currently supports Alibaba Cloud ROS and Terraform workflows.

Language: English | 中文 | Español | Français | Deutsch | 日本語 | Português

Documentation: https://aliyun.github.io/iac-code/

Installation

IaC Code requires Python 3.10 or later. It supports macOS, Linux, and Windows.

Windows note: On Windows, Git for Windows must be installed to provide the bash shell used by the tool execution environment. If Git Bash is installed but not on PATH, set the IAC_CODE_GIT_BASH_PATH environment variable.

pip install iac-code

Usage

On first use, configure the LLM provider and IaC cloud service by entering /auth in interactive mode.

Interactive Mode

Run directly to enter the interactive REPL:

iac-code

Non-Interactive Mode

Pass a one-shot prompt via --prompt:

iac-code --prompt "Create a VPC and two ECS instances"

Reading from stdin is also supported:

echo "Create an OSS Bucket" | iac-code --prompt -

Web App

Prefer a graphical interface? Launch the local web app, which runs the same engine as the CLI and shares the same sessions. The web app needs the http extra, so install it first:

pip install 'iac-code[http]'
iac-code web

By default it opens http://127.0.0.1:8766 in your browser (loopback only). See the Web App guide for details.

Contributing

Install uv, then:

make install   # install dependencies and pre-commit hooks
make dev       # run in debug mode
make test      # run tests
make lint      # run linters
make format    # format code

See the Contributing Guide for details.

Contact Us

DingTalk	Discord