# yaml-language-server: $schema=https://schema.zeabur.app/template.json
apiVersion: zeabur.com/v1
kind: Template
metadata:
    name: MiroFish
spec:
    description: |
        MiroFish is an AI prediction engine that builds a digital parallel world from your data. Upload seed materials, describe your prediction goal, and thousands of AI agents with distinct personalities simulate social interactions to generate outcome reports.
    coverImage: https://raw.githubusercontent.com/666ghj/MiroFish/main/static/image/Screenshot/%E8%BF%90%E8%A1%8C%E6%88%AA%E5%9B%BE1.png
    icon: https://raw.githubusercontent.com/666ghj/MiroFish/main/frontend/public/icon.png
    variables:
        - key: PUBLIC_DOMAIN
          type: DOMAIN
          name: Domain
          description: The domain to access MiroFish
        - key: LLM_API_KEY
          type: STRING
          name: LLM API Key
          description: API key for your LLM service (OpenAI-compatible)
        - key: ZEP_API_KEY
          type: STRING
          name: Zep Cloud API Key
          description: API key from Zep Cloud for agent memory
    tags:
        - AI
        - Tool
    readme: |
        # MiroFish

        An AI prediction engine powered by multi-agent simulation. Upload seed materials (news, policies, financial data, or even fiction), describe what you want to predict, and MiroFish deploys thousands of AI agents with distinct personalities and memory to interact in a digital parallel world — generating prediction reports based on simulated outcomes.

        ## Prerequisites

        MiroFish requires **two external API keys** before it can function:

        1. **LLM API Key** — any OpenAI-compatible API (this template defaults to Alibaba DashScope / qwen-plus)
           - Recommended: [Zeabur AI Hub](https://zeabur.com/ai-hub?referralCode=futurizerush) — get your API key directly on Zeabur, supports Claude, GPT, Gemini and more. Set `LLM_BASE_URL` to `https://hnd1.aihub.zeabur.ai/` and `LLM_MODEL_NAME` to e.g. `gpt-4.1-mini`
           - Or use [OpenAI](https://platform.openai.com/) (`LLM_BASE_URL` = `https://api.openai.com/v1`), [Alibaba Bailian](https://bailian.console.aliyun.com/) (`https://dashscope.aliyuncs.com/compatible-mode/v1`), or other OpenAI-compatible providers
        2. **Zep Cloud API Key** — for agent memory and knowledge graphs
           - Sign up at [Zep Cloud](https://app.getzep.com/) (free tier available)

        ## What You Can Do After Deployment

        1. **Open your domain** — access the MiroFish interface
        2. **Upload seed materials** — provide news articles, policy documents, financial data, or other text
        3. **Describe your prediction** — use natural language to explain what outcome you want to simulate
        4. **Run simulation** — MiroFish creates AI agents that interact and evolve, then generates a prediction report
        5. **Chat with agents** — interact with the simulated agents to explore different scenarios

        ## Use Cases

        - **Public opinion analysis** — predict how the public might react to events or announcements
        - **Policy testing** — simulate the impact of policy changes before implementation
        - **Creative exploration** — deduce possible endings for stories or explore fictional scenarios
        - **Financial forecasting** — analyze market trends (experimental)

        ## Environment Variables

        | Variable | Description |
        |----------|-------------|
        | `LLM_API_KEY` | Your LLM API key (required) |
        | `LLM_BASE_URL` | LLM API endpoint (default: Alibaba DashScope) |
        | `LLM_MODEL_NAME` | Model name (default: `qwen-plus`) |
        | `ZEP_API_KEY` | Zep Cloud API key for agent memory (required) |
        | `LLM_BOOST_API_KEY` | Optional secondary LLM for acceleration |
        | `LLM_BOOST_BASE_URL` | Optional secondary LLM endpoint |
        | `LLM_BOOST_MODEL_NAME` | Optional secondary LLM model name |
        | `OASIS_DEFAULT_MAX_ROUNDS` | Max simulation rounds (default: 10). Higher = more detailed but costs more tokens |

        ## Important Notes

        - LLM token consumption can be significant. Start with simulations under 40 rounds
        - The free Zep Cloud tier is sufficient for basic usage
        - This project is at an early stage (v0.1.2); APIs may change

        ## License

        AGPL-3.0 — [GitHub](https://github.com/666ghj/MiroFish)
    services:
        - name: mirofish
          icon: https://raw.githubusercontent.com/666ghj/MiroFish/main/frontend/public/icon.png
          template: PREBUILT_V2
          spec:
            id: mirofish
            source:
                image: ghcr.io/666ghj/mirofish:v0.1.2
                command:
                    - sh
                    - -c
                    - 'sed -i ''s/server: {/server: { allowedHosts: true,/'' /app/frontend/vite.config.js && sed -i ''/baseURL:/s#baseURL:.*#baseURL: "",#'' /app/frontend/src/api/index.js && npm run dev'
            ports:
                - id: web
                  port: 3000
                  type: HTTP
            volumes:
                - id: uploads
                  dir: /app/backend/uploads
            env:
                FLASK_DEBUG:
                    default: "false"
                LLM_API_KEY:
                    default: ${LLM_API_KEY}
                LLM_BASE_URL:
                    default: https://dashscope.aliyuncs.com/compatible-mode/v1
                LLM_MODEL_NAME:
                    default: qwen-plus
                OASIS_DEFAULT_MAX_ROUNDS:
                    default: "10"
                SECRET_KEY:
                    default: ${PASSWORD}
                ZEP_API_KEY:
                    default: ${ZEP_API_KEY}
            healthCheck:
                type: HTTP
                port: web
                http:
                    path: /
          domainKey: PUBLIC_DOMAIN
localization:
    es-ES:
        description: |
            MiroFish es un motor de prediccion con IA que construye un mundo digital paralelo a partir de tus datos. Sube materiales semilla, describe tu objetivo de prediccion, y miles de agentes IA con personalidades distintas simulan interacciones sociales para generar informes predictivos.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: Dominio
              description: El dominio para acceder a MiroFish
            - key: LLM_API_KEY
              type: STRING
              name: LLM API Key
              description: Clave API del servicio LLM (compatible con OpenAI)
            - key: ZEP_API_KEY
              type: STRING
              name: Zep Cloud API Key
              description: Clave API de Zep Cloud para memoria de agentes
        readme: |
            # MiroFish

            Motor de prediccion con IA basado en simulacion multi-agente. Sube materiales semilla (noticias, politicas, datos financieros o ficcion), describe lo que quieres predecir, y MiroFish despliega miles de agentes IA con personalidades y memoria independientes que interactuan en un mundo digital paralelo para generar informes predictivos.

            ## Requisitos previos

            MiroFish requiere **dos claves API externas** para funcionar:

            1. **LLM API Key** — cualquier API compatible con OpenAI (por defecto: Alibaba DashScope / qwen-plus)
               - Recomendado: [Zeabur AI Hub](https://zeabur.com/ai-hub?referralCode=futurizerush) — obtene tu API key directamente en Zeabur, compatible con Claude, GPT, Gemini y mas. Configura `LLM_BASE_URL` como `https://hnd1.aihub.zeabur.ai/` y `LLM_MODEL_NAME` como `gpt-4.1-mini`
               - O usa [OpenAI](https://platform.openai.com/) (`LLM_BASE_URL` = `https://api.openai.com/v1`), [Alibaba Bailian](https://bailian.console.aliyun.com/) (`https://dashscope.aliyuncs.com/compatible-mode/v1`) u otros servicios compatibles
            2. **Zep Cloud API Key** — para memoria y grafos de conocimiento de agentes
               - Registrate en [Zep Cloud](https://app.getzep.com/) (plan gratuito disponible)

            ## Que puedes hacer despues del despliegue

            1. **Abre tu dominio** — accede a la interfaz de MiroFish
            2. **Sube materiales semilla** — proporciona noticias, documentos de politicas, datos financieros u otros textos
            3. **Describe tu prediccion** — usa lenguaje natural para explicar que resultado quieres simular
            4. **Ejecuta la simulacion** — MiroFish crea agentes IA que interactuan y evolucionan, generando un informe predictivo
            5. **Chatea con agentes** — interactua con los agentes simulados para explorar diferentes escenarios

            ## Notas importantes

            - El consumo de tokens LLM puede ser significativo. Comienza con simulaciones de menos de 40 rondas
            - El plan gratuito de Zep Cloud es suficiente para uso basico
            - Proyecto en etapa inicial (v0.1.2); las APIs pueden cambiar

            ## Licencia

            AGPL-3.0 — [GitHub](https://github.com/666ghj/MiroFish)
    id-ID:
        description: |
            MiroFish adalah mesin prediksi AI yang membangun dunia digital paralel dari data Anda. Unggah materi awal, jelaskan tujuan prediksi, dan ribuan agen AI dengan kepribadian berbeda mensimulasikan interaksi sosial untuk menghasilkan laporan prediksi.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: Domain
              description: Domain untuk mengakses MiroFish
            - key: LLM_API_KEY
              type: STRING
              name: LLM API Key
              description: API key layanan LLM (kompatibel OpenAI)
            - key: ZEP_API_KEY
              type: STRING
              name: Zep Cloud API Key
              description: API key Zep Cloud untuk memori agen
        readme: |
            # MiroFish

            Mesin prediksi AI berbasis simulasi multi-agen. Unggah materi awal (berita, kebijakan, data keuangan, atau fiksi), jelaskan apa yang ingin Anda prediksi, dan MiroFish mengerahkan ribuan agen AI dengan kepribadian dan memori independen yang berinteraksi di dunia digital paralel untuk menghasilkan laporan prediksi.

            ## Prasyarat

            MiroFish memerlukan **dua API key eksternal** untuk berfungsi:

            1. **LLM API Key** — API kompatibel OpenAI (default: Alibaba DashScope / qwen-plus)
               - Direkomendasikan: [Zeabur AI Hub](https://zeabur.com/ai-hub?referralCode=futurizerush) — dapatkan API key langsung di Zeabur, mendukung Claude, GPT, Gemini, dan lainnya. Set `LLM_BASE_URL` ke `https://hnd1.aihub.zeabur.ai/` dan `LLM_MODEL_NAME` ke misalnya `gpt-4.1-mini`
               - Atau gunakan [OpenAI](https://platform.openai.com/) (`LLM_BASE_URL` = `https://api.openai.com/v1`), [Alibaba Bailian](https://bailian.console.aliyun.com/) (`https://dashscope.aliyuncs.com/compatible-mode/v1`), atau layanan kompatibel lainnya
            2. **Zep Cloud API Key** — untuk memori agen dan knowledge graph
               - Daftar di [Zep Cloud](https://app.getzep.com/) (tier gratis tersedia)

            ## Yang Dapat Dilakukan Setelah Deploy

            1. **Buka domain** — akses antarmuka MiroFish
            2. **Unggah materi awal** — berikan berita, dokumen kebijakan, data keuangan, atau teks lainnya
            3. **Jelaskan tujuan prediksi** — gunakan bahasa alami untuk menjelaskan hasil yang ingin disimulasikan
            4. **Jalankan simulasi** — agen AI berinteraksi dan berevolusi, menghasilkan laporan prediksi
            5. **Chat dengan agen** — berinteraksi dengan agen simulasi untuk menjelajahi skenario berbeda

            ## Kasus Penggunaan

            - **Analisis opini publik** — prediksi reaksi publik terhadap peristiwa atau pengumuman
            - **Pengujian kebijakan** — simulasi dampak perubahan kebijakan sebelum diterapkan
            - **Eksplorasi kreatif** — deduksi kemungkinan akhir cerita, eksplorasi skenario fiksi
            - **Prediksi keuangan** — analisis tren pasar (eksperimental)

            ## Catatan Penting

            - Konsumsi token LLM cukup besar. Mulai dengan simulasi kurang dari 40 ronde
            - Tier gratis Zep Cloud cukup untuk penggunaan dasar
            - Proyek masih tahap awal (v0.1.2); API dapat berubah

            ## Lisensi

            AGPL-3.0 — [GitHub](https://github.com/666ghj/MiroFish)
    ja-JP:
        description: |
            MiroFish はAI予測エンジンです。データからデジタルパラレルワールドを構築し、独立した人格を持つ数千のAIエージェントが社会的相互作用をシミュレーションして予測レポートを生成します。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: ドメイン
              description: MiroFish にアクセスするためのドメイン
            - key: LLM_API_KEY
              type: STRING
              name: LLM API Key
              description: LLMサービスのAPIキー（OpenAI互換）
            - key: ZEP_API_KEY
              type: STRING
              name: Zep Cloud API Key
              description: エージェントメモリ用のZep Cloud APIキー
        readme: |
            # MiroFish

            マルチエージェントシミュレーションによるAI予測エンジン。シード素材（ニュース、政策、金融データ、小説など）をアップロードし、予測目標を自然言語で記述すると、独立した人格と記憶を持つ数千のAIエージェントがデジタルパラレルワールドで相互作用し、予測レポートを生成します。

            ## 前提条件

            MiroFishの動作には**2つの外部APIキー**が必要です：

            1. **LLM API Key** — OpenAI互換のAPI（デフォルト：Alibaba DashScope / qwen-plus）
               - おすすめ：[Zeabur AI Hub](https://zeabur.com/ai-hub?referralCode=futurizerush) — Zeabur上で直接APIキーを取得、Claude・GPT・Gemini等に対応。`LLM_BASE_URL`を`https://hnd1.aihub.zeabur.ai/`、`LLM_MODEL_NAME`を例えば`gpt-4.1-mini`に設定
               - または[OpenAI](https://platform.openai.com/)（`LLM_BASE_URL` = `https://api.openai.com/v1`）、[Alibaba Bailian](https://bailian.console.aliyun.com/)（`https://dashscope.aliyuncs.com/compatible-mode/v1`）等を使用
            2. **Zep Cloud API Key** — エージェントメモリとナレッジグラフ
               - [Zep Cloud](https://app.getzep.com/)で取得（無料枠あり）

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

            1. **ドメインにアクセス** — MiroFishのインターフェースを開く
            2. **シード素材をアップロード** — ニュース、政策文書、金融データなどのテキストを提供
            3. **予測目標を記述** — 自然言語でシミュレーションしたい結果を説明
            4. **シミュレーション実行** — AIエージェントが相互作用・進化し、予測レポートを生成
            5. **エージェントと対話** — シミュレーション中のエージェントと対話し、異なるシナリオを探索

            ## ユースケース

            - **世論分析** — イベントや発表に対する世論の反応を予測
            - **政策テスト** — 実施前に政策変更の影響をシミュレーション
            - **創作探求** — 物語の結末を推理し、架空のシナリオを探索
            - **金融予測** — 市場トレンドの分析（実験的）

            ## 注意事項

            - LLMトークン消費量が大きいため、まず40ラウンド以下のシミュレーションから開始してください
            - Zep Cloud無料枠で基本的な使用が可能
            - 初期段階のプロジェクト（v0.1.2）のため、APIが変更される可能性があります

            ## ライセンス

            AGPL-3.0 — [GitHub](https://github.com/666ghj/MiroFish)
    ko-KR:
        description: |
            MiroFish는 AI 예측 엔진입니다. 데이터에서 디지털 병렬 세계를 구축하고, 독립적인 인격을 가진 수천 개의 AI 에이전트가 사회적 상호작용을 시뮬레이션하여 예측 보고서를 생성합니다.
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 도메인
              description: MiroFish에 접속할 도메인
            - key: LLM_API_KEY
              type: STRING
              name: LLM API Key
              description: LLM 서비스 API 키 (OpenAI 호환)
            - key: ZEP_API_KEY
              type: STRING
              name: Zep Cloud API Key
              description: 에이전트 메모리용 Zep Cloud API 키
        readme: |
            # MiroFish

            멀티 에이전트 시뮬레이션 기반 AI 예측 엔진. 시드 자료(뉴스, 정책, 금융 데이터, 소설 등)를 업로드하고 예측 목표를 자연어로 설명하면, 독립적인 인격과 기억을 가진 수천 개의 AI 에이전트가 디지털 병렬 세계에서 상호작용하여 예측 보고서를 생성합니다.

            ## 사전 요구사항

            MiroFish 작동에는 **2개의 외부 API 키**가 필요합니다:

            1. **LLM API Key** — OpenAI 호환 API (기본값: Alibaba DashScope / qwen-plus)
               - 추천: [Zeabur AI Hub](https://zeabur.com/ai-hub?referralCode=futurizerush) — Zeabur에서 직접 API 키 발급, Claude·GPT·Gemini 등 지원. `LLM_BASE_URL`을 `https://hnd1.aihub.zeabur.ai/`로, `LLM_MODEL_NAME`을 예: `gpt-4.1-mini`로 설정
               - 또는 [OpenAI](https://platform.openai.com/) (`LLM_BASE_URL` = `https://api.openai.com/v1`), [Alibaba Bailian](https://bailian.console.aliyun.com/) (`https://dashscope.aliyuncs.com/compatible-mode/v1`) 등 사용
            2. **Zep Cloud API Key** — 에이전트 메모리 및 지식 그래프
               - [Zep Cloud](https://app.getzep.com/)에서 발급 (무료 티어 사용 가능)

            ## 배포 후 할 수 있는 것

            1. **도메인 접속** — MiroFish 인터페이스 열기
            2. **시드 자료 업로드** — 뉴스, 정책 문서, 금융 데이터 등 텍스트 제공
            3. **예측 목표 설명** — 자연어로 시뮬레이션할 결과 설명
            4. **시뮬레이션 실행** — AI 에이전트가 상호작용하고 진화하여 예측 보고서 생성
            5. **에이전트와 대화** — 시뮬레이션 중인 에이전트와 대화하여 다른 시나리오 탐색

            ## 주의사항

            - LLM 토큰 소비가 크므로 먼저 40라운드 이하 시뮬레이션부터 시작하세요
            - Zep Cloud 무료 티어로 기본 사용 가능
            - 초기 단계 프로젝트(v0.1.2)로 API가 변경될 수 있습니다

            ## 라이선스

            AGPL-3.0 — [GitHub](https://github.com/666ghj/MiroFish)
    th-TH:
        description: |
            MiroFish เป็นเอนจินทำนายด้วย AI ที่สร้างโลกดิจิทัลคู่ขนานจากข้อมูลของคุณ อัปโหลดวัสดุตั้งต้น อธิบายเป้าหมายการทำนาย และตัวแทน AI นับพันที่มีบุคลิกภาพเฉพาะตัวจะจำลองปฏิสัมพันธ์ทางสังคมเพื่อสร้างรายงานการทำนาย
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: โดเมน
              description: โดเมนสำหรับเข้าถึง MiroFish
            - key: LLM_API_KEY
              type: STRING
              name: LLM API Key
              description: API key ของบริการ LLM (รองรับ OpenAI)
            - key: ZEP_API_KEY
              type: STRING
              name: Zep Cloud API Key
              description: API key ของ Zep Cloud สำหรับหน่วยความจำเอเจนต์
        readme: |
            # MiroFish

            เอนจินทำนายด้วย AI ที่ใช้การจำลองแบบมัลติเอเจนต์ อัปโหลดวัสดุตั้งต้น (ข่าว นโยบาย ข้อมูลการเงิน หรือนิยาย) อธิบายสิ่งที่คุณต้องการทำนาย และ MiroFish จะส่งตัวแทน AI นับพันที่มีบุคลิกภาพและความทรงจำเฉพาะตัว ปฏิสัมพันธ์ในโลกดิจิทัลคู่ขนาน เพื่อสร้างรายงานการทำนาย

            ## ข้อกำหนดเบื้องต้น

            MiroFish ต้องใช้ **API key ภายนอก 2 ตัว** จึงจะทำงานได้:

            1. **LLM API Key** — API ที่รองรับ OpenAI (ค่าเริ่มต้น: Alibaba DashScope / qwen-plus)
               - แนะนำ: [Zeabur AI Hub](https://zeabur.com/ai-hub?referralCode=futurizerush) — รับ API key ได้โดยตรงบน Zeabur รองรับ Claude, GPT, Gemini และอื่นๆ ตั้ง `LLM_BASE_URL` เป็น `https://hnd1.aihub.zeabur.ai/` และ `LLM_MODEL_NAME` เป็น เช่น `gpt-4.1-mini`
               - หรือใช้ [OpenAI](https://platform.openai.com/) (`LLM_BASE_URL` = `https://api.openai.com/v1`), [Alibaba Bailian](https://bailian.console.aliyun.com/) (`https://dashscope.aliyuncs.com/compatible-mode/v1`) หรือบริการอื่นๆ
            2. **Zep Cloud API Key** — สำหรับหน่วยความจำเอเจนต์และกราฟความรู้
               - สมัครที่ [Zep Cloud](https://app.getzep.com/) (มีแพลนฟรี)

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

            1. **เปิดโดเมน** — เข้าสู่อินเทอร์เฟซ MiroFish
            2. **อัปโหลดวัสดุตั้งต้น** — ให้ข่าว เอกสารนโยบาย ข้อมูลการเงิน หรือข้อความอื่นๆ
            3. **อธิบายเป้าหมายการทำนาย** — ใช้ภาษาธรรมชาติอธิบายผลลัพธ์ที่ต้องการจำลอง
            4. **รันการจำลอง** — เอเจนต์ AI ปฏิสัมพันธ์และวิวัฒนาการ สร้างรายงานการทำนาย
            5. **แชทกับเอเจนต์** — สนทนากับเอเจนต์ในการจำลองเพื่อสำรวจสถานการณ์ต่างๆ

            ## กรณีการใช้งาน

            - **วิเคราะห์ความคิดเห็นสาธารณะ** — คาดการณ์ปฏิกิริยาของสาธารณชนต่อเหตุการณ์หรือประกาศ
            - **ทดสอบนโยบาย** — จำลองผลกระทบของการเปลี่ยนแปลงนโยบายก่อนดำเนินการ
            - **สำรวจเชิงสร้างสรรค์** — สรุปตอนจบที่เป็นไปได้ของเรื่องราว สำรวจสถานการณ์สมมติ
            - **พยากรณ์การเงิน** — วิเคราะห์แนวโน้มตลาด (ทดลอง)

            ## หมายเหตุสำคัญ

            - การใช้ LLM token ค่อนข้างมาก เริ่มจากการจำลองที่น้อยกว่า 40 รอบ
            - แพลนฟรีของ Zep Cloud เพียงพอสำหรับการใช้งานพื้นฐาน
            - โปรเจกต์อยู่ในระยะเริ่มต้น (v0.1.2) API อาจเปลี่ยนแปลง

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

            AGPL-3.0 — [GitHub](https://github.com/666ghj/MiroFish)
    zh-CN:
        description: |
            MiroFish 是一个 AI 预测引擎，从你的数据中构建数字平行世界。上传种子素材、描述预测目标，上千个具备独立人格的 AI Agent 模拟社会互动，生成预测报告。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 域名
              description: 访问 MiroFish 的域名
            - key: LLM_API_KEY
              type: STRING
              name: LLM API Key
              description: LLM 服务的 API 密钥（OpenAI 兼容格式）
            - key: ZEP_API_KEY
              type: STRING
              name: Zep Cloud API Key
              description: Zep Cloud 的 API 密钥，用于 Agent 记忆
        readme: |
            # MiroFish

            AI 预测引擎，通过多智能体模拟运作。上传种子素材（新闻、政策、金融数据、甚至小说），描述你要预测的目标，MiroFish 会部署上千个具备独立人格与记忆的 AI Agent，在数字平行世界中互动，根据模拟结果生成预测报告。

            ## 前置需求

            MiroFish 需要**两个外部 API Key** 才能运作：

            1. **LLM API Key** — 任何 OpenAI 兼容的 API（本模板默认使用阿里百炼 / qwen-plus）
               - 推荐使用 [Zeabur AI Hub](https://zeabur.com/ai-hub?referralCode=futurizerush) — 直接在 Zeabur 平台获取，支持 Claude、GPT、Gemini 等模型。将 `LLM_BASE_URL` 设为 `https://hnd1.aihub.zeabur.ai/`，`LLM_MODEL_NAME` 设为如 `gpt-4.1-mini`
               - 或使用 [OpenAI](https://platform.openai.com/)（`LLM_BASE_URL` = `https://api.openai.com/v1`）、[阿里百炼](https://bailian.console.aliyun.com/)（`https://dashscope.aliyuncs.com/compatible-mode/v1`）等 OpenAI 兼容服务
            2. **Zep Cloud API Key** — Agent 记忆与知识图谱服务
               - 在 [Zep Cloud](https://app.getzep.com/) 申请（有免费额度）

            ## 部署后可以做什么

            1. **打开域名** — 进入 MiroFish 界面
            2. **上传种子素材** — 提供新闻、政策文件、金融数据等文字资料
            3. **描述预测目标** — 用自然语言说明你想模拟什么结果
            4. **执行模拟** — MiroFish 创建 AI Agent 进行互动演化，生成预测报告
            5. **与 Agent 对话** — 和模拟中的 Agent 互动，探索不同情境

            ## 使用场景

            - **舆情分析** — 预测公众对事件或公告的反应
            - **政策测试** — 在实施前模拟政策变动的影响
            - **创意探索** — 推演故事可能的结局，探索虚构情境
            - **金融预测** — 分析市场趋势（实验性）

            ## 注意事项

            - LLM token 消耗量较大，建议先从 40 轮以下的模拟开始
            - Zep Cloud 免费额度足够基本使用
            - 此项目处于早期阶段（v0.1.2），API 可能变动

            ## 授权

            AGPL-3.0 — [GitHub](https://github.com/666ghj/MiroFish)
    zh-TW:
        description: |
            MiroFish 是一個 AI 預測引擎，從你的資料中建構數位平行世界。上傳種子素材、描述預測目標，上千個具備獨立人格的 AI Agent 模擬社會互動，生成預測報告。
        variables:
            - key: PUBLIC_DOMAIN
              type: STRING
              name: 網域
              description: 存取 MiroFish 的網域
            - key: LLM_API_KEY
              type: STRING
              name: LLM API Key
              description: LLM 服務的 API 金鑰（OpenAI 相容格式）
            - key: ZEP_API_KEY
              type: STRING
              name: Zep Cloud API Key
              description: Zep Cloud 的 API 金鑰，用於 Agent 記憶
        readme: |
            # MiroFish

            AI 預測引擎，透過多 AI Agents 模擬運作。上傳種子素材（新聞、政策、金融數據、甚至小說），描述你要預測的目標，MiroFish 會部署上千個具備獨立人格與記憶的 AI Agent，在數位平行世界中互動，根據模擬結果生成預測報告。

            ## 前置需求

            MiroFish 需要**兩個外部 API Key** 才能運作：

            1. **LLM API Key** — 任何 OpenAI 相容的 API（本模板預設使用阿里百煉 / qwen-plus）
               - 推薦使用 [Zeabur AI Hub](https://zeabur.com/ai-hub?referralCode=futurizerush) — 直接在 Zeabur 平台取得，支援 Claude、GPT、Gemini 等模型。將 `LLM_BASE_URL` 設為 `https://hnd1.aihub.zeabur.ai/`，`LLM_MODEL_NAME` 設為如 `gpt-4.1-mini`
               - 或使用 [OpenAI](https://platform.openai.com/)（`LLM_BASE_URL` = `https://api.openai.com/v1`）、[阿里百煉](https://bailian.console.aliyun.com/)（`https://dashscope.aliyuncs.com/compatible-mode/v1`）等 OpenAI 相容服務
            2. **Zep Cloud API Key** — AI Agent 記憶管理服務
               - 在 [Zep Cloud](https://app.getzep.com/) 申請（有免費額度）

            ## 部署後可以做什麼

            1. **開啟網域** — 進入 MiroFish 介面
            2. **上傳種子素材** — 提供新聞、政策文件、金融數據等文字資料
            3. **描述預測目標** — 用自然語言說明你想模擬什麼結果
            4. **執行模擬** — MiroFish 建立 AI Agent 進行互動演化，生成預測報告
            5. **與 AI Agent 對話** — 和模擬中的 AI Agent 互動，探索不同情境

            ## 使用場景

            - **輿情分析** — 預測公眾對事件或公告的反應
            - **政策測試** — 在實施前模擬政策變動的影響
            - **創意探索** — 推演故事可能的結局，探索虛構情境
            - **金融預測** — 分析市場趨勢（實驗性）

            ## 注意事項

            - LLM token 消耗量較大，建議先從 40 輪以下的模擬開始
            - Zep Cloud 免費額度足夠基本使用
            - 此專案處於早期階段（v0.1.2），API 可能變動

            ## 授權

            AGPL-3.0 — [GitHub](https://github.com/666ghj/MiroFish)