{"id":32658373,"url":"https://github.com/mintplex-labs/helm-charts","last_synced_at":"2026-01-23T03:23:26.419Z","repository":{"id":318757434,"uuid":"1070941795","full_name":"Mintplex-Labs/helm-charts","owner":"Mintplex-Labs","description":"Helm Charts for AnythingLLM and other resources maintained by Mintplex Labs Inc.","archived":false,"fork":false,"pushed_at":"2025-10-14T22:23:28.000Z","size":25,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-13T09:54:23.924Z","etag":null,"topics":["ai-tools","anythingllm","deployment","docker","helm","helm-charts","k8s-deployment","kubernetes","localai"],"latest_commit_sha":null,"homepage":"https://mintplex-labs.github.io/helm-charts/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mintplex-Labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-06T16:38:07.000Z","updated_at":"2025-11-30T00:32:25.000Z","dependencies_parsed_at":"2025-10-15T06:24:02.684Z","dependency_job_id":"99f681c6-fe1e-467a-aa47-069bb6a916a6","html_url":"https://github.com/Mintplex-Labs/helm-charts","commit_stats":null,"previous_names":["mintplex-labs/helm-charts"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Mintplex-Labs/helm-charts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mintplex-Labs%2Fhelm-charts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mintplex-Labs%2Fhelm-charts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mintplex-Labs%2Fhelm-charts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mintplex-Labs%2Fhelm-charts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mintplex-Labs","download_url":"https://codeload.github.com/Mintplex-Labs/helm-charts/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mintplex-Labs%2Fhelm-charts/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28679144,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T01:00:35.747Z","status":"online","status_checked_at":"2026-01-23T02:00:08.296Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","anythingllm","deployment","docker","helm","helm-charts","k8s-deployment","kubernetes","localai"],"created_at":"2025-10-31T13:31:29.805Z","updated_at":"2026-01-23T03:23:26.410Z","avatar_url":"https://github.com/Mintplex-Labs.png","language":"HTML","readme":"# Mintplex Labs Helm Charts\n\nThis is the central repository for Mintplex Labs Helm Charts, providing production-ready Kubernetes deployments for various applications.\n\n## 📋 Table of Contents\n\n- [Usage](#usage)\n- [Available Charts](#available-charts)\n- [Repository Architecture](#repository-architecture)\n- [Development Workflow](#development-workflow)\n- [GitHub Pages Integration](#github-pages-integration)\n- [Contributing](#contributing)\n- [Troubleshooting](#troubleshooting)\n\n## 🚀 Usage\n\n### Prerequisites\n\n[Helm](https://helm.sh) must be installed to use the charts.\nPlease refer to Helm's [documentation](https://helm.sh/docs/) to get started.\n\n### Adding the Repository\n\nOnce Helm is set up properly, add the repo as follows:\n\n```bash\nhelm repo add mintplex-labs https://mintplex-labs.github.io/helm-charts\n```\n\nIf you had already added this repo earlier, run `helm repo update` to retrieve the latest versions of the packages:\n\n```bash\nhelm repo update\n```\n\n### Searching and Installing Charts\n\nYou can then run `helm search repo mintplex-labs` to see the charts:\n\n```bash\nhelm search repo mintplex-labs\n```\n\nInstall a chart with:\n\n```bash\nhelm install my-release mintplex-labs/\u003cchart-name\u003e\n```\n\n### Alternative Installation Methods\n\n#### OCI Registry (GitHub Container Registry)\n\nCharts are also available via OCI registry:\n\n```bash\n# Install directly from OCI registry\nhelm install my-release oci://ghcr.io/mintplex-labs/helm-charts/\u003cchart-name\u003e --version \u003cversion\u003e\n```\n\n#### Direct from GitHub Releases\n\nDownload chart packages directly from [GitHub Releases](https://github.com/mintplex-labs/helm-charts/releases):\n\n```bash\n# Download and install from release assets\nwget https://github.com/mintplex-labs/helm-charts/releases/download/\u003cchart-name\u003e-\u003cversion\u003e/\u003cchart-name\u003e-\u003cversion\u003e.tgz\nhelm install my-release ./\u003cchart-name\u003e-\u003cversion\u003e.tgz\n```\n\n## 🏗️ Repository Architecture\n\nThis repository follows a structured approach to manage and distribute Helm charts:\n\n### Directory Structure\n\n```\n├── .github/\n│   └── workflows/\n│       └── helm.yml              # CI/CD pipeline for chart releases\n├── charts/\n│   └── \u003cchart-name\u003e/\n│       ├── Chart.yaml            # Chart metadata\n│       ├── values.yaml           # Default configuration values\n│       ├── README.md             # Chart-specific documentation\n│       └── templates/            # Kubernetes manifest templates\n├── index.html                    # GitHub Pages landing page\n└── README.md                     # This file\n```\n\n### Branching Strategy\n\n- **`main`**: Primary development branch containing chart sources\n- **`gh-pages`**: Auto-generated branch serving the Helm repository via GitHub Pages\n\n## 🔄 Development Workflow\n\n### How the Repository Works\n\nThis repository uses a sophisticated CI/CD pipeline that automatically:\n\n1. **Builds and validates** charts when changes are pushed to `main`\n2. **Publishes charts** to multiple distribution channels\n3. **Updates the repository index** for seamless chart discovery\n\n### Automated Release Process\n\nWhen you push changes to the `charts/` directory on the `main` branch, the following happens automatically:\n\n#### 1. Chart Validation\n\n```yaml\n# The CI pipeline performs:\n- helm dependency build # Downloads chart dependencies\n- helm lint # Validates chart syntax and best practices\n- helm package # Creates distributable .tgz files\n```\n\n#### 2. Multi-Channel Publishing\n\n**a) OCI Registry (GitHub Container Registry)**\n\n- Charts are pushed to `ghcr.io/mintplex-labs/helm-charts/\u003cchart-name\u003e`\n- Enables modern `helm install oci://` installation method\n- Provides container-native distribution\n\n**b) GitHub Releases**\n\n- Creates individual releases tagged as `\u003cchart-name\u003e-\u003cversion\u003e`\n- Attaches chart `.tgz` files as release assets\n- Generates rich release notes with installation instructions\n\n**c) Traditional Helm Repository (GitHub Pages)**\n\n- Updates the `gh-pages` branch with chart packages\n- Generates/updates `index.yaml` for Helm repository discovery\n- Serves charts via `https://mintplex-labs.github.io/helm-charts`\n\n#### 3. Repository Index Updates\n\nThe pipeline automatically:\n\n- Downloads all chart packages from GitHub Releases\n- Generates a new `index.yaml` with all available charts and versions\n- Updates the GitHub Pages site with the latest repository index\n- Copies the main `index.html` landing page to the gh-pages branch\n\n## 🌐 GitHub Pages Integration\n\n### How GitHub Pages Serves the Helm Repository\n\nThe repository leverages GitHub Pages to provide a traditional Helm repository endpoint:\n\n#### Repository Structure (gh-pages branch)\n\n```\ngh-pages/\n├── README.md               # README (copied from main branch)\n├── index.html              # Landing page (copied from main branch)\n├── index.yaml              # Helm repository index (auto-generated)\n```\n\n#### Access Points\n\n1. **Helm Repository**: `https://mintplex-labs.github.io/helm-charts`\n\n   - Accessed via `helm repo add` commands\n   - Serves `index.yaml` for chart discovery\n\n2. **Landing Page**: `https://mintplex-labs.github.io/helm-charts`\n\n   - User-friendly web interface\n   - Installation instructions and chart documentation\n\n3. **Direct Package Access**: `https://mintplex-labs.github.io/helm-charts/packages/\u003cchart-name\u003e-\u003cversion\u003e.tgz`\n   - Direct download links for chart packages\n\n### Repository Index (`index.yaml`)\n\nThe `index.yaml` file is the heart of a Helm repository, containing:\n\n- Chart metadata (name, version, description)\n- Download URLs for chart packages\n- Checksums for package integrity\n- Dependencies and requirements\n\nExample structure:\n\n```yaml\napiVersion: v1\nentries:\n  chart-name:\n    - name: chart-name\n      version: 1.0.0\n      appVersion: \"1.0\"\n      description: Chart description\n      urls:\n        - https://mintplex-labs.github.io/helm-charts/packages/chart-name-1.0.0.tgz\n      digest: sha256:...\n      created: \"2025-10-12T10:00:00Z\"\n```\n\n## 🛠️ Contributing\n\n### For Chart Developers\n\n#### Adding a New Chart\n\n1. **Create Chart Structure**:\n\n   ```bash\n   mkdir -p charts/my-new-chart\n   cd charts/my-new-chart\n   helm create .  # Or create manually\n   ```\n\n2. **Update Chart.yaml**:\n\n   ```yaml\n   apiVersion: v2\n   name: my-new-chart\n   description: A Helm chart for my application\n   version: 0.1.0\n   appVersion: \"1.0\"\n   ```\n\n3. **Configure values.yaml**:\n\n   - Set sensible defaults\n   - Document all configuration options\n   - Follow consistent naming conventions\n\n4. **Create README.md**:\n   - Installation instructions\n   - Configuration options table\n   - Usage examples\n\n#### Updating Existing Charts\n\n1. **Bump Version**: Update `version` in `Chart.yaml`\n2. **Update App Version**: Update `appVersion` if the underlying application version changed\n3. **Document Changes**: Update the chart's README.md with changes\n4. **Test Locally**:\n   ```bash\n   helm lint charts/my-chart\n   helm template test charts/my-chart\n   ```\n\n#### Version Conventions\n\nFollow [Semantic Versioning](https://semver.org/):\n\n- **MAJOR**: Incompatible API changes\n- **MINOR**: Backwards-compatible functionality additions\n- **PATCH**: Backwards-compatible bug fixes\n\n### Workflow Integration Points\n\n#### CI/CD Pipeline (`.github/workflows/helm.yml`)\n\nThe workflow is triggered by:\n\n- **Path Filter**: Only runs when files in `charts/**` are modified\n- **Branch Filter**: Only runs on pushes to `main` branch\n\nKey workflow steps:\n\n1. **Setup**: Configures Helm, Git, and required tools\n2. **Validation**: Lints and validates all charts\n3. **Packaging**: Creates distributable chart packages\n4. **Publishing**: Pushes to OCI registry and creates GitHub releases\n5. **Repository Update**: Updates GitHub Pages with new chart index\n\n#### Environment Variables\n\nThe workflow uses these environment variables:\n\n- `REGISTRY`: OCI registry URL (`ghcr.io/mintplex-labs/helm-charts`)\n- `GITHUB_TOKEN`: Automatically provided for authentication\n- `GITHUB_ACTOR`: GitHub username for Git configuration\n\n#### Permissions Required\n\nThe workflow requires these permissions:\n\n```yaml\npermissions:\n  contents: write # For creating releases and updating gh-pages\n  packages: write # For pushing to GitHub Container Registry\n  pull-requests: write # For PR automation (future use)\n```\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n#### Chart Not Appearing in Repository\n\n1. **Check Workflow Status**: Verify the GitHub Actions workflow completed successfully\n2. **Verify Chart Structure**: Ensure `Chart.yaml` is valid and properly formatted\n3. **Check Version**: Ensure you bumped the chart version in `Chart.yaml`\n4. **Repository Cache**: Run `helm repo update` to refresh your local cache\n\n#### OCI Registry Issues\n\n1. **Authentication**: Verify GitHub Container Registry permissions\n2. **Package Visibility**: Check if packages are public in GitHub settings\n3. **Version Conflicts**: Ensure you're not trying to overwrite an existing version\n\n#### GitHub Pages Not Updating\n\n1. **Workflow Permissions**: Verify the workflow has `contents: write` permission\n2. **Branch Protection**: Check if `gh-pages` branch has protection rules\n3. **Pages Settings**: Ensure GitHub Pages is enabled and pointing to `gh-pages` branch\n\n### Development Tips\n\n#### Local Testing\n\n```bash\n# Lint charts\nhelm lint charts/*\n\n# Test template rendering\nhelm template test-release charts/my-chart\n\n# Test installation (with dry-run)\nhelm install test-release charts/my-chart --dry-run --debug\n\n# Package locally\nhelm package charts/my-chart\n```\n\n#### Debugging Workflow\n\n1. **Check Workflow Logs**: Navigate to Actions tab in GitHub\n2. **Validate YAML**: Use `yamllint` to check chart YAML files\n3. **Test Locally**: Reproduce the workflow steps locally before pushing\n\n### Getting Help\n\n- **Issues**: Create an issue in this repository for bugs or feature requests\n- **Discussions**: Use GitHub Discussions for questions and community support\n- **Documentation**: Refer to [Helm's official documentation](https://helm.sh/docs/)\n\n---\n\n## 📚 Additional Resources\n\n- [Helm Documentation](https://helm.sh/docs/)\n- [Helm Best Practices](https://helm.sh/docs/chart_best_practices/)\n- [GitHub Pages Documentation](https://docs.github.com/en/pages)\n- [GitHub Container Registry](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry)\n\n---\n\n**Maintainer**: Mintplex Labs Team\n**Repository**: https://github.com/mintplex-labs/helm-charts\n**Website**: https://mintplexlabs.com\n\n---\n\n**Credit**: [Sam Culley](https://github.com/sculley) for the original repository structure and foundation.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmintplex-labs%2Fhelm-charts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmintplex-labs%2Fhelm-charts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmintplex-labs%2Fhelm-charts/lists"}