Skip to content

Repository files navigation

iac-code

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

Test PyPI Package Python

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

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

Download IaC Code Desktop
macOS Apple Silicon · Windows x64 · Linux AppImage · Linux deb · All release files

Desktop App

No Python, pip, or terminal setup required — download the native app and start building cloud infrastructure right away. Get the package for your platform from the latest GitHub Release:

  • 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.

IaC Code Desktop app

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. Stable macOS packages are signed with Apple Developer ID and notarized by Apple; stable Windows packages carry an Authenticode publisher signature. Always download from the official release page and verify the accompanying SHA256SUMS. See the Desktop App guide for installation and troubleshooting details.

Installation

The CLI and Web app below run on Python 3.10 or later, on macOS, Linux, and Windows. If you only use the Desktop app, you can skip this section.

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. If it is not installed yet, run iac-code install-git-bash to install Git for Windows automatically (downloaded via the npmmirror mirror).

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

iac-code demo

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.

IaC Code Web app

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
DingTalk Discord

About

AI-powered Infrastructure as Code assistant for Alibaba Cloud (ROS / Terraform) through natural language interaction.

Topics

Resources

Stars

26 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages