Installation

Official v0.3.0 release artifacts require no runtime besides the binary. They are built with Go 1.26.7 and CGO_ENABLED=0.

A v0.3.0 binary prints 0.3.0. Git tags use a v prefix (v0.3.0). Untagged local builds print 0.0.0-dev.

GitHub Releases

1. Download the v0.3.0 archive for your OS and architecture.
2. Download checksums.txt from the same release and verify the archive.
3. Extract agoraform (agoraform.exe on Windows) and place it on PATH.
4. Confirm the version:

agoraform --version

Release archives:

File	Platform
agoraform_0.3.0_linux_amd64.tar.gz	Linux amd64
agoraform_0.3.0_linux_arm64.tar.gz	Linux arm64
agoraform_0.3.0_darwin_amd64.tar.gz	macOS amd64
agoraform_0.3.0_darwin_arm64.tar.gz	macOS arm64
agoraform_0.3.0_windows_amd64.zip	Windows amd64

The archives also contain the README, changelog, license files, the v0.1 goal example, the complete v0.2 Matomo conversion example, and the complete v0.3 Google Ads conversion example.

Verify checksums

Linux:

sha256sum -c checksums.txt --ignore-missing

macOS (replace the archive name for Intel Macs):

shasum -a 256 agoraform_0.3.0_darwin_arm64.tar.gz
grep 'agoraform_0.3.0_darwin_arm64.tar.gz' checksums.txt

The two SHA-256 values must match.

Windows PowerShell:

Get-FileHash .\agoraform_0.3.0_windows_amd64.zip -Algorithm SHA256
Select-String 'agoraform_0.3.0_windows_amd64.zip' .\checksums.txt

The two SHA-256 values must match before you run the binary.

go install

Requires Go 1.26.7 or newer:

go install github.com/dziblo-music/agoraform/cmd/agoraform@v0.3.0

Build from source

git clone https://github.com/dziblo-music/agoraform.git
cd agoraform
git checkout v0.3.0
go build -o agoraform ./cmd/agoraform
./agoraform --version

On Windows:

go build -o agoraform.exe ./cmd/agoraform

A plain untagged go build reports 0.0.0-dev. Release builds inject the version rather than hard-coding it in source.

Next

Continue with the quick start.