# Install naml with Homebrew

Convert Kubernetes YAML to Golang. Version 1.0.3 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:naml
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install naml
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:naml
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/naml>
- **Version:** 1.0.3
- **Source summary:** Convert Kubernetes YAML to Golang
- **Homepage:** <https://github.com/krisnova/naml>
- **Repository:** <https://github.com/krisnova/naml>
- **Upstream docs:** <https://github.com/krisnova/naml#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/krisnova/naml/archive/refs/tags/v1.0.3.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- naml (cli)
- naml (alias)

## Dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.0.3
- Local data: ok
- Upstream repository: https://github.com/krisnova/naml
- Upstream latest detected: v1.0.3 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

naml, short for Not Another Markup Language, is Kris Nova's Go tool for converting Kubernetes YAML into Go code and treating Kubernetes applications as compiled Go programs.

### Project history

The repository was created on 2021-06-12. The README frames naml as both a Go library and a CLI for developing and deploying Kubernetes applications, replacing YAML with raw Go so users can rely on Go syntax highlighting, cross-compiling, code generation, documentation, tests, and the Kubernetes client libraries.

The project moved quickly toward a 1.0 release in 2021. GitHub releases show v0.3.0 as the YAML release on 2021-08-20, v0.4.0 as a deployable release candidate on 2021-11-20, v1.0.0 on 2021-11-21, and v1.0.3 on 2021-11-24.

### Adoption history

naml had attention in the Kubernetes developer niche but not broad package-manager usage. Repository metadata consulted on 2026-07-01 showed 1,261 GitHub stars and 36 forks, while Homebrew listed 74 installs over the prior 365 days.

Its significance is tied to a recurring Kubernetes argument: whether YAML should be generated, templated, or replaced by typed code. naml chose the typed-code side, using existing Kubernetes Go APIs rather than inventing another runtime templating system.

### How it is used

The README's main workflow is `cat deploy.yaml | naml codify > main.go`, then `naml build -o app`, then running the generated application to emit YAML, install, or uninstall resources. It can also convert all objects in a namespace from `kubectl get all -n default -o yaml`.

Package nerds use naml as a translator and experiment harness: take existing manifests, turn them into formatted Go that implements a Deployable interface, inspect the generated Kubernetes objects, and decide whether code-backed deployment makes sense for a project.

### Why package nerds care

naml is not the default Kubernetes packaging path; Helm, Kustomize, Jsonnet, CUE, CDK8s, and Pulumi cover adjacent ground. Its value is historical and practical: it captures the 2021 wave of 'YAML fatigue' in a small Go-native tool.

### Timeline

- 2021-06-12: GitHub repository created.
- 2021-08-20: v0.3.0 YAML release published.
- 2021-11-20: v0.4.0 deployable release candidate published.
- 2021-11-21: v1.0.0 first major stable release published.
- 2021-11-24: v1.0.3 published.
- 2026-07-01: Homebrew Formulae page listed 74 installs over the prior 365 days.

### Related projects

- Kubernetes client-go
- kind
- Helm
- Kustomize
- Jsonnet
- CUE
- cdk8s
- Pulumi

### Sources

- <https://api.github.com/repos/krisnova/naml>
- <https://api.github.com/repos/krisnova/naml/releases?per_page=10>
- <https://formulae.brew.sh/formula/naml>
- <https://github.com/krisnova/naml>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** naml
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Runtime dependency declared by Homebrew.
- [kconf](https://www.automicvault.com/pkg/brew/kconf/) - Shares av.db curated category or tags: cli, cloud-infrastructure, configuration, kubernetes.
- [kubetrim](https://www.automicvault.com/pkg/brew/kubetrim/) - Shares av.db curated category or tags: cli, cloud-infrastructure, configuration, kubernetes.
- [vals](https://www.automicvault.com/pkg/brew/vals/) - Shares av.db curated category or tags: cli, cloud-infrastructure, configuration, kubernetes.
- [consul-template](https://www.automicvault.com/pkg/brew/consul-template/) - Shares av.db curated category or tags: cli, cloud-infrastructure, configuration.
- [kustomize](https://www.automicvault.com/pkg/brew/kustomize/) - Shares av.db curated category or tags: cli, cloud-infrastructure, configuration, kubernetes, yaml.
- [qbec](https://www.automicvault.com/pkg/brew/qbec/) - Shares av.db curated category or tags: cli, cloud-infrastructure, configuration, kubernetes.
- [helmify](https://www.automicvault.com/pkg/brew/helmify/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes, yaml.
- [kustomizer](https://www.automicvault.com/pkg/brew/kustomizer/) - Shares av.db curated category or tags: cli, cloud-infrastructure, configuration, kubernetes.

## Combined YAML source

View the package source record on GitHub. [combined/naml.yml](https://github.com/automic-vault/db/blob/main/combined/naml.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
