terrafy 0.1.0

CLI to crete production ready HCL configuration with human language

terrafy

CLI to generate production-ready Terraform HCL configuration from human language — powered by Gemini.

---

How It Works

1. Authenticate — provide your Gemini API key
2. Create — describe your infrastructure in plain English
3. Done — terrafy generates a .tf file and saves it locally

---

Installation

Requirements

• Python 3.9+
• Gemini API key

Build & Install

python3 -m build
pip3 install .

Rebuild (clean)

rm -rf build/ dist/ src/*.egg-info
python3 -m build
pip3 install .

---

Usage

Step 1 — Authenticate

terrafy authenticate <GEMINI_API_KEY>

Step 2 — Generate HCL

terrafy create "Create an S3 bucket to hold images. The name starts with the environment then project prefix"

This will:

• Call Gemini with your request
• Print the generated HCL to the terminal
• Save it to a named .tf file (e.g. s3_bucket.tf) in your current directory

View Docs

terrafy docs

---

Commands

Command	Description	Example
authenticate	Set your Gemini API key	terrafy authenticate sk-qwerty
create	Generate HCL from a natural language request	terrafy create "S3 bucket for images"
docs	Show usage instructions	terrafy docs

---

Dependencies

• typer — CLI framework
• rich — terminal formatting
• google-genai — Gemini API client