Skip to content

mishamyrt/hapm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

78 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Home Assistant Package Manager

hapm prepares Home Assistant custom integrations and plugins for Docker-based deployments.

Installation

go install github.com/mishamyrt/hapm

Docker

The image is available on Docker Hub:

docker pull mishamyrt/hapm

Run a full install (sync cache + export to Home Assistant config) with one command:

docker run --rm \
  -v "$PWD/hapm.yaml:/tmp/hapm.yaml:ro" \
  -v "$PWD/.hapm:/tmp/.hapm" \
  -v "$PWD:/config" \
  mishamyrt/hapm install /config

Manifest format

hapm.yaml contains package locations grouped by package kind.

integrations:
  - mishamyrt/dohome_rgb@v0.6.0
  - AlexxIT/YandexStation@v3.20.1
plugins:
  - PiotrMachowski/lovelace-xiaomi-vacuum-map-card@v2.2.2

Location format:

  • owner/repo@version
  • https://github.com/owner/repo@version
  • owner/repo (uses latest)

Commands

Global flags (available for all commands):

  • -m, --manifest (default: hapm.yaml)
  • -s, --storage (default: .hapm)
  • -d, --dry (print planned changes only)

Initialize empty manifest

hapm init

Add or update package entries in manifest

Add a new package (with type):

hapm add --type integrations mishamyrt/assisted_pol@v0.2.4

Update an existing package version:

hapm add mishamyrt/assisted_pol@v0.2.5

Install from manifest

hapm install /config

install performs both steps in one run:

  1. Syncs cache in storage (.hapm by default)
  2. Exports to the destination path:
    • integrations -> /config/custom_components
    • plugins -> /config/www/custom_lovelace

No separate sync or export commands are required.

List installed packages

hapm list

Show available updates

hapm updates

Show available versions for a package

hapm versions mishamyrt/assisted_pol

About

📦 HACS alternative for Docker–based Home Assistant

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors