{"id":24336,"library":"pyhelm3","title":"pyhelm3","description":"A Python library for managing Helm releases using Helm 3. It wraps the Helm CLI to provide a programmatic interface for installing, upgrading, listing, and uninstalling Helm charts. Current version 0.4.0. Release cadence is irregular.","status":"active","version":"0.4.0","language":"python","source_language":"en","source_url":"https://github.com/azimuth-cloud/pyhelm3","tags":["helm","kubernetes","devops"],"install":[{"cmd":"pip install pyhelm3","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Used for data models. Version 0.2.0 switched from Pydantic v1 to v2.","package":"pydantic","optional":false},{"reason":"Requires Helm 3 CLI installed on the system.","package":"helm3","optional":false}],"imports":[{"note":"HelmReleases is top-level in pyhelm3 package.","wrong":"from pyhelm3.client import HelmReleases","symbol":"HelmReleases","correct":"from pyhelm3 import HelmReleases"},{"note":"HelmRelease is top-level, not under models.","wrong":"from pyhelm3.models import HelmRelease","symbol":"HelmRelease","correct":"from pyhelm3 import HelmRelease"}],"quickstart":{"code":"import os\nfrom pyhelm3 import HelmReleases\n\nreleases = HelmReleases()\n# List all releases\nfor release in releases.list():\n    print(release.name, release.status)\n\n# Install a release\nreleases.install(\n    'my-release',\n    chart='stable/nginx-ingress',\n    values={'controller.replicaCount': 2},\n    namespace='default',\n    atomic=True\n)","lang":"python","description":"Create a HelmReleases client, list releases, and install a chart."},"warnings":[{"fix":"Ensure your code is compatible with Pydantic v2.","message":"Version 0.2.0 changed from Pydantic v1 to v2. If you have custom models or validators that rely on Pydantic v1 behavior, upgrade carefully.","severity":"breaking","affected_versions":">=0.2.0"},{"fix":"Use https://github.com/azimuth-cloud/pyhelm3 instead of https://github.com/stackhpc/pyhelm3.","message":"Repository moved from stackhpc to azimuth-cloud in version 0.4.0. Update your remote if you have it as a git dependency.","severity":"breaking","affected_versions":">=0.4.0"},{"fix":"Install Helm 3 via your package manager or from https://helm.sh/docs/intro/install/.","message":"Helm CLI must be installed and available in PATH. The library does not bundle Helm.","severity":"gotcha","affected_versions":"all"},{"fix":"When comparing values, handle empty dict case explicitly.","message":"Empty values dict is returned as an empty dict (not None) starting from version 0.3.4. This may affect comparisons.","severity":"gotcha","affected_versions":">=0.3.4"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install Helm 3 and ensure it's in your system PATH.","cause":"Helm CLI not installed or not in PATH.","error":"FileNotFoundError: [Errno 2] No such file or directory: 'helm'"},{"fix":"Install pydantic-settings or pin to pyhelm3<0.2.0 if you need Pydantic v1.","cause":"Project uses Pydantic v2 which moved BaseSettings to pydantic-settings package.","error":"pydantic.errors.PydanticImportError: `BaseSettings` has been moved to `pydantic-settings`"},{"fix":"Run: pip install pyhelm3","cause":"Package not installed.","error":"ModuleNotFoundError: No module named 'pyhelm3'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}