Installation

HexaGo requires Go 1.25 or later. Choose your preferred installation method below.

---

Using Go Install

The simplest method — installs the latest release directly from the module proxy:

go install github.com/padiazg/hexago@latest

To install a specific version:

go install github.com/padiazg/hexago@v0.4.0

Tip

Make sure $GOPATH/bin (or $HOME/go/bin) is in your PATH:

export PATH="$PATH:$(go env GOPATH)/bin"

---

Using Homebrew

brew tap padiazg/hexago
brew install hexago

---

Build from Source

git clone https://github.com/padiazg/hexago.git
cd hexago
go build -o hexago

Then move the binary somewhere on your PATH:

mv hexago /usr/local/bin/hexago
# or
mv hexago ~/go/bin/hexago

---

Verify Installation

hexago --help

You should see output like:

HexaGo - Hexagonal Architecture Scaffolding CLI

Usage:
  hexago [command]

Available Commands:
  init        Initialize a new hexagonal architecture project
  add         Add components to an existing project
  validate    Validate hexagonal architecture compliance
  version     Show version information
  mcp         Start the MCP server for AI assistants
  templates   List, export, or check code generation templates

Flags:
  -h, --help      help for hexago
  -v, --verbose   Enable verbose output

---

Prerequisites

Requirement	Version	Notes
Go	1.25+	Required to install and build
Git	Any	For cloning and version control

Note

HexaGo generates static binaries (CGO_ENABLED=0), so generated projects can be deployed without external dependencies.

---

Platform Support

Pre-built binaries are available for:

• Linux x86_64
• Linux arm64
• macOS x86_64 (Intel)
• macOS arm64 (Apple Silicon)

Download from GitHub Releases.

---

Next Steps

Once installed, head to the Quick Start guide to create your first project.