# yaml-language-server: $schema=https://schema.zeabur.app/template.json
apiVersion: zeabur.com/v1
kind: Template
metadata:
    name: Gorse
spec:
    description: |
        Gorse is an open-source AI-powered recommendation engine written in Go. It provides a web dashboard for managing items, users, and recommendation pipelines. Supports classical and LLM-based rankers with multimodal content via embeddings.
    coverImage: https://raw.githubusercontent.com/gorse-io/gorse/master/assets/dashboard.png
    icon: https://raw.githubusercontent.com/gorse-io/gorse/master/assets/gorse.png
    variables:
        - key: PUBLIC_DOMAIN
          type: DOMAIN
          name: Domain
          description: The domain to access Gorse dashboard
    tags:
        - Tool
        - AI
    readme: |
        # Gorse

        An open-source AI-powered recommendation engine. Provides a web dashboard for managing items, users, and recommendation strategies with real-time system monitoring.

        ## Getting Started

        This template deploys Gorse in **all-in-one playground mode**, which bundles all components (master, worker, server) and an embedded database into a single container. It automatically imports sample data from GitRec for demonstration.

        ## What You Can Do After Deployment

        1. **Visit your domain** — the Gorse dashboard opens at the root URL
        2. **Explore the dashboard** — view system status, recommendation pipeline, and data overview
        3. **Manage items and users** — add, edit, or import items and users via the dashboard or REST API
        4. **Configure recommendation strategies** — tune collaborative filtering, content-based, and popularity-based algorithms
        5. **Integrate via REST API** — fetch personalized recommendations for your application at `/api/recommend/:user_id`
        6. **Monitor system metrics** — track recommendation quality, training progress, and cache status

        ## Key Features

        - Collaborative filtering (matrix factorization, nearest neighbors)
        - Content-based recommendation via embeddings
        - LLM-powered rankers for advanced personalization
        - Real-time recommendation serving via REST API
        - Web dashboard for pipeline management and monitoring
        - Auto-tuning of model parameters
        - Multi-source data import (CSV, JSON, API)

        ## API Examples

        ```bash
        # Get recommendations for a user
        curl https://YOUR_DOMAIN/api/recommend/user_id

        # Insert feedback
        curl -X POST https://YOUR_DOMAIN/api/feedback \
          -H "Content-Type: application/json" \
          -d '[{"FeedbackType":"star","UserId":"bob","ItemId":"item_1"}]'
        ```

        ## License

        Apache-2.0 — [GitHub](https://github.com/gorse-io/gorse)
    services:
        - name: gorse
          icon: https://raw.githubusercontent.com/gorse-io/gorse/master/assets/gorse.png
          template: PREBUILT_V2
          spec:
            source:
                image: zhenghaoz/gorse-in-one:0.5.6
                command:
                    - /usr/bin/gorse-in-one
                    - --playground
            ports:
                - id: web
                  port: 8088
                  type: HTTP
            volumes:
                - id: gorse-data
                  dir: /var/lib/gorse
            env:
                TZ:
                    default: UTC
            healthCheck:
                type: HTTP
                port: web
                http:
                    path: /
          domainKey: PUBLIC_DOMAIN
localization:
    es-ES:
        description: |
            Gorse es un motor de recomendacion impulsado por IA y de codigo abierto escrito en Go. Proporciona un panel web para gestionar elementos, usuarios y pipelines de recomendacion.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: Dominio
              description: El dominio para acceder al panel de Gorse
        readme: |
            # Gorse

            Motor de recomendacion de codigo abierto impulsado por IA. Panel web para gestionar estrategias de recomendacion.

            ## Que puedes hacer despues del despliegue

            1. **Visita tu dominio** — el panel de Gorse se muestra en la pagina principal
            2. **Explora el panel** — consulta el estado del sistema y el pipeline de recomendaciones
            3. **Gestiona elementos y usuarios** — a traves del panel o la API REST

            ## Licencia

            Apache-2.0 — [GitHub](https://github.com/gorse-io/gorse)
    id-ID:
        description: |
            Gorse adalah mesin rekomendasi bertenaga AI open-source yang ditulis dalam Go. Menyediakan dasbor web untuk mengelola item, pengguna, dan pipeline rekomendasi.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: Domain
              description: Domain untuk mengakses dasbor Gorse
        readme: |
            # Gorse

            Mesin rekomendasi bertenaga AI open-source. Dasbor web untuk mengelola strategi rekomendasi.

            ## Apa yang bisa dilakukan setelah deploy

            1. **Buka domain** — dasbor Gorse ditampilkan di halaman utama
            2. **Jelajahi dasbor** — lihat status sistem dan pipeline rekomendasi
            3. **Kelola item dan pengguna** — melalui dasbor atau REST API

            ## Lisensi

            Apache-2.0 — [GitHub](https://github.com/gorse-io/gorse)
    ja-JP:
        description: |
            Gorse はオープンソースの AI 推薦エンジンです。Go で開発され、Web ダッシュボードでアイテム・ユーザー・推薦パイプラインを管理できます。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: ドメイン
              description: Gorse ダッシュボードにアクセスするドメイン
        readme: |
            # Gorse

            オープンソースの AI 推薦エンジン。Web ダッシュボードで推薦戦略を管理。

            ## デプロイ後にできること

            1. **ドメインにアクセス** — ダッシュボードが表示されます
            2. **ダッシュボードを確認** — システム状態と推薦パイプラインを閲覧
            3. **アイテムとユーザーを管理** — REST API 経由でデータを操作

            ## ライセンス

            Apache-2.0 — [GitHub](https://github.com/gorse-io/gorse)
    ko-KR:
        description: |
            Gorse는 Go로 작성된 오픈소스 AI 추천 엔진입니다. 웹 대시보드로 아이템, 사용자, 추천 파이프라인을 관리합니다.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 도메인
              description: Gorse 대시보드에 접속할 도메인
        readme: |
            # Gorse

            오픈소스 AI 추천 엔진. 웹 대시보드로 추천 전략을 관리합니다.

            ## 배포 후 할 수 있는 것

            1. **도메인 접속** — 대시보드가 표시됩니다
            2. **대시보드 탐색** — 시스템 상태와 추천 파이프라인 확인
            3. **아이템 및 사용자 관리** — REST API로 데이터 조작

            ## 라이선스

            Apache-2.0 — [GitHub](https://github.com/gorse-io/gorse)
    th-TH:
        description: |
            Gorse เป็นเครื่องยนต์แนะนำที่ขับเคลื่อนด้วย AI แบบโอเพนซอร์ส เขียนด้วย Go มีแดชบอร์ดเว็บสำหรับจัดการรายการ ผู้ใช้ และ pipeline การแนะนำ
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: โดเมน
              description: โดเมนสำหรับเข้าถึงแดชบอร์ด Gorse
        readme: |
            # Gorse

            เครื่องยนต์แนะนำแบบโอเพนซอร์สขับเคลื่อนด้วย AI แดชบอร์ดเว็บสำหรับจัดการกลยุทธ์การแนะนำ

            ## สิ่งที่ทำได้หลังจากติดตั้ง

            1. **เข้าสู่โดเมน** — แดชบอร์ดจะแสดงที่หน้าหลัก
            2. **สำรวจแดชบอร์ด** — ดูสถานะระบบและ pipeline การแนะนำ
            3. **จัดการรายการและผู้ใช้** — ผ่านแดชบอร์ดหรือ REST API

            ## สัญญาอนุญาต

            Apache-2.0 — [GitHub](https://github.com/gorse-io/gorse)
    zh-CN:
        description: |
            Gorse 是开源的 AI 驱动推荐引擎，用 Go 编写。提供 Web 仪表板管理物品、用户和推荐流水线。支持经典和 LLM 排序器。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 域名
              description: 访问 Gorse 仪表板的域名
        readme: |
            # Gorse

            开源的 AI 推荐引擎。提供 Web 仪表板管理物品、用户与推荐策略。

            ## 部署后可以做什么

            1. **打开域名** — Gorse 仪表板显示在首页
            2. **探索仪表板** — 查看系统状态和推荐流水线
            3. **管理物品和用户** — 通过仪表板或 REST API 操作
            4. **配置推荐策略** — 调整协同过滤和基于内容的算法

            ## 授权

            Apache-2.0 — [GitHub](https://github.com/gorse-io/gorse)
    zh-TW:
        description: |
            Gorse 是開源的 AI 驅動推薦引擎，以 Go 撰寫。提供網頁儀表板管理項目、使用者和推薦管線。支援經典和 LLM 排序器，透過嵌入向量處理多模態內容。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 網域
              description: 存取 Gorse 儀表板的網域
        readme: |
            # Gorse

            開源的 AI 推薦引擎。提供網頁儀表板管理項目、使用者與推薦策略，並具備即時系統監控。

            ## 部署後可以做什麼

            1. **開啟網域** — Gorse 儀表板會顯示在首頁
            2. **探索儀表板** — 查看系統狀態、推薦管線和資料概覽
            3. **管理項目和使用者** — 透過儀表板或 REST API 新增、編輯或匯入資料
            4. **設定推薦策略** — 調整協同過濾、基於內容和熱門排行的演算法
            5. **透過 REST API 整合** — 為應用程式取得個人化推薦

            ## 授權

            Apache-2.0 — [GitHub](https://github.com/gorse-io/gorse)
