{"id":30188689,"url":"https://github.com/rhecosystemappeng/rhdh-templates","last_synced_at":"2026-01-20T17:10:21.179Z","repository":{"id":288470414,"uuid":"966991905","full_name":"RHEcosystemAppEng/RHDH-templates","owner":"RHEcosystemAppEng","description":"Repository to manage RHDH templates","archived":false,"fork":false,"pushed_at":"2025-10-02T00:03:43.000Z","size":5250,"stargazers_count":2,"open_issues_count":1,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-02T00:11:58.809Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RHEcosystemAppEng.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-04-15T18:58:23.000Z","updated_at":"2025-10-02T00:03:46.000Z","dependencies_parsed_at":"2025-05-07T20:23:28.145Z","dependency_job_id":"5aac19a8-1c8b-4769-80d7-60b3faa5ef24","html_url":"https://github.com/RHEcosystemAppEng/RHDH-templates","commit_stats":null,"previous_names":["rhecosystemappeng/rhdh-templates"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/RHEcosystemAppEng/RHDH-templates","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RHEcosystemAppEng%2FRHDH-templates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RHEcosystemAppEng%2FRHDH-templates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RHEcosystemAppEng%2FRHDH-templates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RHEcosystemAppEng%2FRHDH-templates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RHEcosystemAppEng","download_url":"https://codeload.github.com/RHEcosystemAppEng/RHDH-templates/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RHEcosystemAppEng%2FRHDH-templates/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28607624,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T16:10:39.856Z","status":"ssl_error","status_checked_at":"2026-01-20T16:10:39.493Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2025-08-12T17:45:54.809Z","updated_at":"2026-01-20T17:10:21.173Z","avatar_url":"https://github.com/RHEcosystemAppEng.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"This guide provides step-by-step instructions for installing the Red Hat Golden Template path using the RHEcosystemAppEng/RHDH-templates repository.\n\n\n---\n\n## ✅ Prerequisites\n\nBefore getting started, ensure you have the following:\n\n- **OpenShift CLI (oc)**: [Download and install](https://developers.redhat.com/learning/learn:openshift:download-and-install-red-hat-openshift-cli/resource/resources:download-and-install-oc) Openshift command-line interface\n- **Platform Access**: Access to either [TAP](https://docs.redhat.com/en/documentation/red_hat_trusted_application_pipeline/1.0/html-single/installing_red_hat_trusted_application_pipeline/index) or a running RHDH instance. Helm Chart installation available [here](https://github.com/redhat-ai-dev/ai-rhdh-installer)\n-  **Hugging Face API Token**: A valid authentication token from [Hugging Face](https://huggingface.co/docs/hub/en/security-tokens)\n---\n### 🚀 Step-by-Step Instructions\n\n### 1. Create a Kubernetes secret for HF token\n\n\n## 🔓 Without Vault\nSet up your Hugging Face authentication:\n1. Configure your token as an environment variable:\n   ```bash\n   export HF_TOKEN=\u003cyour huggingface token\u003e\n   ```\n   Replace \u003cyour-huggingface-token\u003e with your actual Hugging Face API token.\n\n2. Create the secret in your OpenShift namespace:\n   ```bash\n   oc create secret generic huggingface-secret \\\n     -n \u003cyour-namespace\u003e \\\n     --from-literal=HF_TOKEN=$HF_TOKEN\n   ```\n   Replace \u003cyour-namespace\u003e with the namespace where your RAG application is deployed.\n\n\n---\n\n### 🔐 With Vault + External Secrets Operator\n\u003e **Note**: Use this approach if you have Vault and External Secrets Operator configured in your cluster for centralized secret management.\n\n1. **Access Vault UI**:\n   ```bash\n   # Get the Vault route\n   oc get route -n vault\n   \n   # Get the Vault token\n   oc get secret -n vault vault-token -o jsonpath=\"{.data.token}\" | base64 --decode\n   ```\n   Open the Vault route in your browser and log in using the token method with the retrieved token.\n   \n   \u003cimg src=\"images/vaultlogin.jpg\" alt=\"Vault Login Screen\" width=\"300\"\u003e\n\n2. **Create the secret in Vault**:\n   - Select the **KV** secret engine\n   - Navigate to: `secret/`\n   - Set path as: `secrets/ai-kickstart`\n   - Click **Create secret** (Shown on image 1)\n   - Add secret data:\n     - **Key**: `hf_token`\n     - **Value**: `\u003cyour-huggingface-token\u003e`\n   - Click **Save** (Shown on image 2)\n  \n      (1)\n\n      \u003cimg src=\"images/create-secret.jpg\" alt=\"Create ai-ckstart secret\" width=\"300\"\u003e\n      \n      (2)\n\n      \u003cimg src=\"images/ai-kickstart.jpg\" alt=\"Create ai-ckstart secret\" width=\"300\"\u003e  \n      \n  \u003e **Note**: **The ExternalSecret Operator will map `hf_token` → Kubernetes key `HF_TOKEN`**\n\n---\n\n### 2. Login to Developer Hub\n   * Sign in to Developer Hub via GitLab using your GitLab credentials\n\n     \u003cimg src=\"images/dh-dashboard.jpg\" alt=\"Create ai-ckstart secret\" width=\"300\"\u003e\n\n---\n\n### 3. Register AI Templates\n\n1. **Navigate to Create**:\n   - From the Developer Hub sidebar, click **\"Create\"**\n \n      \u003cimg src=\"images/dh-create-view.jpg\" alt=\"Create ai-ckstart secret\" width=\"300\"\u003e\n2. **Register templates**:\n   - Click **\"Register Existing Component\"**\n\n3. **Import the template repository**:\n   - Paste this URL into the input field:\n     ```\n     https://github.com/RHEcosystemAppEng/RHDH-templates/blob/main/showcase-templates.yaml\n     ```\n   - Click **\"Analyze\"**\n\n      \u003cimg src=\"images/register-template.jpg\" alt=\"Create ai-ckstart secret\" width=\"300\"\u003e\n\n   - Click **\"Import\"** to complete registration\n \n      \u003cimg src=\"images/import-template.jpg\" alt=\"Create ai-ckstart secret\" width=\"300\"\u003e\n---\n### 4. Available Templates\n\nOnce registered, you'll see these AI-powered templates in the Catalog-\u003eTemplate page:\n\n- **🤖 RAG Chatbot Kickstart** (`chatbot-rag-kickstart-template`)  \n  Deploy a complete RAG (Retrieval Augmented Generation) architecture using LLaMA Stack, OpenShift AI, and PGVector. Includes document ingestion pipeline and vector database for intelligent question-answering.\n\n- **🎯 AI Virtual Agent** (`ai-virtual-agent-kickstart-template`)  \n  Create an intelligent virtual assistant powered by OpenShift AI and PGVector. Perfect for building conversational AI applications with advanced reasoning capabilities.\n\n- **📊 AI Metrics Summarizer** (`ai-metric-summarizer-kickstart-template`)  \n  Build a specialized chatbot that analyzes AI model performance metrics from Prometheus and generates human-readable summaries using LLaMA models. Ideal for AI observability and monitoring.\n\n---\n### 5. Launch a Template\n\nOnce you've registered the templates, follow these steps to deploy an AI application:\n\n#### **Navigate to Self-Service Catalog**\n- From the Developer Hub sidebar, click **\"Create\"**\n- You'll see the available AI templates listed\n\n#### **Choose Your Template**\nSelect one of the registered templates:\n- **Chatbot-Rag Kickstart** - for RAG document-based Q\u0026A systems\n- **AI Virtual Agent** - for conversational AI assistants  \n- **AI Metrics Summarizer** - for AI observability and monitoring\n\n#### **Configure Template Parameters**\nFill in the guided form with your specifications:\n\n**Application Information:**\n- **Name**: Unique identifier for your component (e.g., `my-ai-chatbot`)\n- **Description**: Brief description of your application\n\n**Repository Details:**\n- **Host Type**: Choose GitHub or GitLab\n- **Repository Owner**: Your organization name\n- **Repository Name**: Name for the source repository\n- **Namespace**: Kubernetes namespace for deployment\n\n**AI Model Configuration:**\n- **Language Model**: Select from available LLaMA variants\n- **Safety Model**: Optional LLaMA Guard for content filtering\n- **GPU Tolerance**: Configure hardware requirements\n\n#### **Review and Create**\n- Review all configured parameters\n- Click **\"Review\"** to validate your inputs\n- Click **\"Create\"** to initiate the template deployment\n\n#### **Automatic Deployment Process**\nThe template will automatically:\n1. **Build** the software component with your specifications\n2. **Publish** source and GitOps repositories to your chosen platform\n3. **Register** the component in the Developer Hub catalog\n4. **Deploy** via ArgoCD using GitOps workflows\n\n#### **Access Your Application**\nOnce complete, use the provided links to:\n- View source repository\n- Monitor GitOps deployment  \n- Access the component in the catalog\n- Review ArgoCD applications\n\n#### **Post-Deployment Steps:**\nOnce your application is deployed, you'll need to make the following changes in your GitOps repository:\n1. Uncomment the Toolhive configuration to enable the service\n2. Delete the chart.lock file to allow Helm to regenerate dependencies\n3. Commit these changes to trigger the GitOps sync","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhecosystemappeng%2Frhdh-templates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frhecosystemappeng%2Frhdh-templates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhecosystemappeng%2Frhdh-templates/lists"}