Set up local development

If you want to work on ContainerHive you can do so, easily.

Before starting to develop make sure you have read the Contribution Guidelines.

Requirements

Make sure to install the following tools:

• Go
• GNU make
• Docker
• pre-commit

Run

go run ./cmd/ch/ -h

Test

Run tests and show the coverage report in your default browser.

make test-coverage-report

Run specific package tests:

go test ./internal/dependency/...

Skip integration tests:

go test -short ./...

Build

Build binaries for all platforms.

make build

Generate embedded resources

Required before building.

make generate

Preview documentation

Preview the properdocs documentation locally with hot-reload for changes.

pip install -r requirements-docs.txt
properdocs serve

AI usage

This project uses AI tooling (Claude Code and Mistral AI models) to assist with development. All AI-generated or AI-assisted changes are human-reviewed and applied responsibly — this is not AI slop. Contributors are expected to uphold the same standard: AI tools are welcome, but every change must be understood, reviewed, and owned by the person submitting it.