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.

Desktop App

For an installed native experience, download the package for your platform from GitHub Releases:

• macOS Apple Silicon: .dmg
• Windows x64: setup .exe
• Linux x64: .AppImage or .deb

The Desktop app runs the same IaC Code engine and uses the same providers, cloud credentials, settings, projects, and sessions as the CLI and Web app. On first launch, select the project directory you want IaC Code to work in. Windows also checks for Git Bash and guides you through installation if it is missing.

macOS, Windows, and AppImage builds can check for and apply cryptographically signed updates in the app. The deb package is updated by installing a newer package. Release installers do not yet carry commercial publisher signatures, so macOS or Windows may display an unknown-developer warning; verify the accompanying SHA256SUMS before installation. See the Desktop App guide for installation and troubleshooting 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