Configuration (HCL)

Amicu configuration is HCL. This page covers the rules shared by every resource. Each resource kind has its own page in this section.

Project files

amicu init creates:

Amicu reads every *.hcl file under the project root, recursively, skipping .amicu/, hidden directories, and target/. You can split resources across files in any layout. Ids must be unique per kind across all files (AMICU-SCHEMA-002).

Language

A file contains only resource blocks. A top-level attribute or any other block type is an error.

resource "model" "qwen3_8b" {
  source {
    registry  = "hugging_face"
    reference = "Qwen/Qwen3.5-8B-Instruct"
  }
  architecture = "qwen3"
  modalities   = ["text"]
  artifact {
    format       = "gguf"
    quantization = "q4_k_m"
  }
  variant {
    quantization = "q4_k_m"
    file         = "qwen3.5-8b-instruct-q4_k_m.gguf"
    size         = "5GiB"
  }
}

• Blocks. resource "<kind>" "<id>" { ... }. The id is the second label.
• Nested blocks such as source {} or llama_cpp {} take no labels. Repeatable blocks (variant, target) can appear more than once.
• Attributes are name = value. Strings are quoted, lists use brackets, numbers and booleans are bare.
• References are <kind>.<id>.id. See Resources and references.
• Secrets are secret("NAME"). See Secrets.
• Sizes are strings with a unit: "48GiB", "8350MiB", "16GB". Binary units (KiB, MiB, GiB, TiB) use powers of 1024; decimal units (KB, MB, GB, TB) use powers of 1000. A bare number is bytes. Values must be integers; "4.5GiB" is not accepted.
• Money is a block: limit { amount = 2000 currency = "EUR" }.
• Unknown keys are errors. A misspelled attribute or block fails with AMICU-SCHEMA-003 and a suggestion. The free-form maps env {} and labels {} accept any key.
• Variables. variables.amicu.hcl is reserved; there is no variable syntax yet, and secret(...) is the only function.

Formatting

amicu fmt              # rewrite *.hcl in canonical form
amicu fmt --check      # exit 1 if any file would change, write nothing
amicu validate --fix   # apply safe repairs (re-formatting only)

fmt re-renders each file from the parsed resources. Comments inside resource files are dropped, and resources are written in a fixed kind order. Use --check in CI to detect drift.

Resource pages

• model
• hardware_profile
• deployment
• routing_policy
• data_class
• governance_rule
• budget
• tenant
• use_case
• credential