Skip to content

Installation

PipelineConductor can be installed via Go install, from source, or using pre-built binaries.

Requirements

  • Go 1.24 or later (for building from source)
  • GitHub personal access token with repo scope

Go Install

The simplest way to install PipelineConductor:

go install github.com/grokify/pipelineconductor/cmd/pipelineconductor@latest

This installs the pipelineconductor binary to your $GOPATH/bin directory.

Build from Source

Clone and build the repository:

git clone https://github.com/grokify/pipelineconductor.git
cd pipelineconductor
go build -o pipelineconductor ./cmd/pipelineconductor

Optionally, install to your PATH:

go install ./cmd/pipelineconductor

Pre-built Binaries

Download pre-built binaries from the GitHub Releases page.

curl -LO https://github.com/grokify/pipelineconductor/releases/latest/download/pipelineconductor_linux_amd64.tar.gz
tar xzf pipelineconductor_linux_amd64.tar.gz
sudo mv pipelineconductor /usr/local/bin/

curl -LO https://github.com/grokify/pipelineconductor/releases/latest/download/pipelineconductor_darwin_arm64.tar.gz
tar xzf pipelineconductor_darwin_arm64.tar.gz
sudo mv pipelineconductor /usr/local/bin/

Download pipelineconductor_windows_amd64.zip and add to your PATH.

Verify Installation

Check that PipelineConductor is installed correctly:

pipelineconductor version

Expected output:

pipelineconductor dev
  commit: none
  built:  unknown

GitHub Token Setup

PipelineConductor requires a GitHub personal access token to access the GitHub API.

Create a Token

  1. Go to GitHub Settings > Developer settings > Personal access tokens
  2. Click "Generate new token (classic)"
  3. Select scopes:
    • repo - Full control of private repositories (or public_repo for public only)
    • read:org - Read organization membership
  4. Generate and copy the token

Configure the Token

Set the token as an environment variable:

export GITHUB_TOKEN=ghp_your_token_here

Or pass it directly to commands:

pipelineconductor scan --github-token ghp_your_token_here --orgs myorg

Token Security

Never commit your GitHub token to version control. Use environment variables or a secrets manager.

Next Steps