# Install dunamai with Homebrew

Dynamic version generation. Version 1.26.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:dunamai
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install dunamai
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:dunamai
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/dunamai>
- **Version:** 1.26.1
- **Source summary:** Dynamic version generation
- **Homepage:** <https://github.com/mtkennerly/dunamai>
- **Repository:** <https://github.com/mtkennerly/dunamai>
- **Upstream docs:** <https://dunamai.readthedocs.io/>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/9f/67/d5611975faaa5e4a920f4b19e4caccd5df0facb925687850f1e45f5876f2/dunamai-1.26.1.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- dunamai (cli)
- dunamai (alias)

## Dependencies

- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.26.1
- Local data: ok
- Upstream repository: https://github.com/mtkennerly/dunamai
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

Dunamai is a Python library and CLI for deriving standards-compliant version strings from version-control tags, aimed at CI builds, release tagging, and dynamic package versions.

### Project history

Dunamai was created in 2019 by Michael Kennerly as an alternative in the dynamic-versioning space. Its README contrasts it with Versioneer, especially for projects that do not use setup.py or do not want generated versioning code committed into the repository.

The project broadened beyond Git-only workflows: official docs list support for Git, Mercurial, Darcs, Subversion, Bazaar, Fossil, and Pijul, and serialization styles including PEP 440, Semantic Versioning, and Haskell PVP.

### Adoption history

Dunamai is distributed as a Python package, a command-line tool, a GitHub Action, and a Homebrew formula. Its most visible related adoption path is poetry-dynamic-versioning, another mtkennerly project that uses VCS tags to enable dynamic versioning in Poetry projects.

### How it is used

Users call commands such as `dunamai from any` in CI or release scripts to produce versions from tags, commit distance, dirty state, branch names, and commit IDs. As a library, it exposes a Version object so build tools can inspect and serialize version parts.

### Why package nerds care

Dunamai matters to package maintainers because dynamic version generation sits at the boundary between VCS history, build backends, Python packaging rules, and reproducible release artifacts. It is a small package, but it codifies a common maintainer desire: tag a release once and let packaging metadata follow.

### Timeline

- 2019: The GitHub repository is created.
- 2019: v0.1.0 is published on GitHub Releases and PyPI.
- 2019: poetry-dynamic-versioning is created as a related Poetry integration.
- 2026: v1.26.1 is published and packaged as Homebrew stable 1.26.1.

### Related projects

- Related projects include Versioneer, setuptools-scm, poetry-dynamic-versioning, Poetry, Flit, GitHub Actions, and the VCS tools that Dunamai can read: Git, Mercurial, Darcs, Subversion, Bazaar, Fossil, and Pijul.

### Sources

- <https://github.com/mtkennerly/dunamai#readme>
- <https://dunamai.readthedocs.io/>
- <https://api.github.com/repos/mtkennerly/dunamai>
- <https://api.github.com/repos/mtkennerly/dunamai/releases>
- <https://pypi.org/pypi/dunamai/json>
- <https://api.github.com/repos/mtkennerly/poetry-dynamic-versioning>
- <https://formulae.brew.sh/formula/dunamai>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

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


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [svu](https://www.automicvault.com/pkg/brew/svu/) - Shares av.db curated category or tags: cli, developer-tools, versioning.
- [bump-my-version](https://www.automicvault.com/pkg/brew/bump-my-version/) - Shares av.db curated category or tags: cli, developer-tools, python, versioning.
- [libversion](https://www.automicvault.com/pkg/brew/libversion/) - Shares av.db curated category or tags: cli, developer-tools, versioning.
- [semtag](https://www.automicvault.com/pkg/brew/semtag/) - Shares av.db curated category or tags: cli, developer-tools, versioning.
- [semver](https://www.automicvault.com/pkg/brew/semver/) - Shares av.db curated category or tags: cli, developer-tools, versioning.
- [abi3audit](https://www.automicvault.com/pkg/brew/abi3audit/) - Shares av.db curated category or tags: cli, developer-tools, python.
- [auditwheel](https://www.automicvault.com/pkg/brew/auditwheel/) - Shares av.db curated category or tags: cli, developer-tools, python.
- [austin](https://www.automicvault.com/pkg/brew/austin/) - Shares av.db curated category or tags: cli, developer-tools, python.
- [eralchemy](https://www.automicvault.com/pkg/brew/eralchemy/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, generation, python.
- [git-big-picture](https://www.automicvault.com/pkg/brew/git-big-picture/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, python, python-3-14.
- [git-imerge](https://www.automicvault.com/pkg/brew/git-imerge/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, python, python-3-14.

## Combined YAML source

View the package source record on GitHub. [combined/dunamai.yml](https://github.com/automic-vault/db/blob/main/combined/dunamai.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
