docs(readme): add Japanese README

README-EN.md

@@ -20,7 +20,7 @@
 [![X](https://img.shields.io/badge/X-Follow-000000?style=flat-square&logo=x&logoColor=white)](https://x.com/mirofish_ai)
 [![Instagram](https://img.shields.io/badge/Instagram-Follow-E4405F?style=flat-square&logo=instagram&logoColor=white)](https://www.instagram.com/mirofish_ai/)
 
-[English](./README-EN.md) | [中文文档](./README.md)
+[English](./README-EN.md) | [中文文档](./README.md) | [日本語](./README-JA.md)
 
 </div>
 
@@ -200,4 +200,4 @@ MiroFish's simulation engine is powered by **[OASIS (Open Agent Social Interacti
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=666ghj/MiroFish&type=date&legend=top-left" />
    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=666ghj/MiroFish&type=date&legend=top-left" />
  </picture>
-</a>
+</a>

README-JA.md

@@ -0,0 +1,203 @@
+<div align="center">
+
+<img src="./static/image/MiroFish_logo_compressed.jpeg" alt="MiroFish Logo" width="75%"/>
+
+<a href="https://trendshift.io/repositories/16144" target="_blank"><img src="https://trendshift.io/api/badge/repositories/16144" alt="666ghj%2FMiroFish | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+
+シンプルで汎用的な群知能エンジン、あらゆるものを予測
+</br>
+<em>A Simple and Universal Swarm Intelligence Engine, Predicting Anything</em>
+
+<a href="https://www.shanda.com/" target="_blank"><img src="./static/image/shanda_logo.png" alt="666ghj%2MiroFish | Shanda" height="40"/></a>
+
+[![GitHub Stars](https://img.shields.io/github/stars/666ghj/MiroFish?style=flat-square&color=DAA520)](https://github.com/666ghj/MiroFish/stargazers)
+[![GitHub Watchers](https://img.shields.io/github/watchers/666ghj/MiroFish?style=flat-square)](https://github.com/666ghj/MiroFish/watchers)
+[![GitHub Forks](https://img.shields.io/github/forks/666ghj/MiroFish?style=flat-square)](https://github.com/666ghj/MiroFish/network)
+[![Docker](https://img.shields.io/badge/Docker-Build-2496ED?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/666ghj/MiroFish)
+
+[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.com/channels/1469200078932545606/1469201282077163739)
+[![X](https://img.shields.io/badge/X-Follow-000000?style=flat-square&logo=x&logoColor=white)](https://x.com/mirofish_ai)
+[![Instagram](https://img.shields.io/badge/Instagram-Follow-E4405F?style=flat-square&logo=instagram&logoColor=white)](https://www.instagram.com/mirofish_ai/)
+
+[English](./README-EN.md) | [中文文档](./README.md) | [日本語](./README-JA.md)
+
+</div>
+
+## ⚡ 概要
+
+**MiroFish** は、マルチエージェント技術を活用した次世代AI予測エンジンです。現実世界からシード情報（ニュース速報、政策草案、金融シグナルなど）を抽出し、高精度なパラレルデジタルワールドを自動構築します。この空間内で、独自の性格・長期記憶・行動ロジックを持つ数千のインテリジェントエージェントが自由に相互作用し、社会的進化を遂げます。「神の視点」から動的に変数を注入することで、未来の軌跡を精密に推論できます — **デジタルサンドボックスで未来をリハーサルし、無数のシミュレーションを経て最適な意思決定を導き出します**。
+
+> 必要な操作は：シード素材（データ分析レポートや興味深い小説など）をアップロードし、予測要件を自然言語で記述するだけ</br>
+> MiroFish が返すもの：詳細な予測レポートと、深くインタラクティブな高精度デジタルワールド
+
+### 私たちのビジョン
+
+MiroFish は、現実を映し出す群知能ミラーの構築を目指しています。個体間の相互作用から生まれる集合的創発を捉えることで、従来の予測の限界を突破します：
+
+- **マクロレベル**：意思決定者のためのリハーサルラボとして、政策や広報をゼロリスクで検証可能
+- **ミクロレベル**：個人ユーザーのためのクリエイティブサンドボックス — 小説の結末推理から想像力豊かなシナリオの探索まで、すべてを楽しく、遊び心を持って体験可能
+
+シリアスな予測から遊び心あるシミュレーションまで、あらゆる「もしも」の結果を可視化し、万物の予測を可能にします。
+
+## 🌐 ライブデモ
+
+オンラインデモ環境をぜひご覧ください。トレンドの世論イベントに関する予測シミュレーションを体験できます：[mirofish-live-demo](https://666ghj.github.io/mirofish-demo/)
+
+## 📸 スクリーンショット
+
+<div align="center">
+<table>
+<tr>
+<td><img src="./static/image/Screenshot/运行截图1.png" alt="スクリーンショット 1" width="100%"/></td>
+<td><img src="./static/image/Screenshot/运行截图2.png" alt="スクリーンショット 2" width="100%"/></td>
+</tr>
+<tr>
+<td><img src="./static/image/Screenshot/运行截图3.png" alt="スクリーンショット 3" width="100%"/></td>
+<td><img src="./static/image/Screenshot/运行截图4.png" alt="スクリーンショット 4" width="100%"/></td>
+</tr>
+<tr>
+<td><img src="./static/image/Screenshot/运行截图5.png" alt="スクリーンショット 5" width="100%"/></td>
+<td><img src="./static/image/Screenshot/运行截图6.png" alt="スクリーンショット 6" width="100%"/></td>
+</tr>
+</table>
+</div>
+
+## 🎬 デモ動画
+
+### 1. 武漢大学世論シミュレーション + MiroFish プロジェクト紹介
+
+<div align="center">
+<a href="https://www.bilibili.com/video/BV1VYBsBHEMY/" target="_blank"><img src="./static/image/武大模拟演示封面.png" alt="MiroFish デモ動画" width="75%"/></a>
+
+画像をクリックして、BettaFish生成の「武漢大学世論レポート」を使用した予測の完全デモ動画をご覧ください
+</div>
+
+### 2. 紅楼夢 失われた結末シミュレーション
+
+<div align="center">
+<a href="https://www.bilibili.com/video/BV1cPk3BBExq" target="_blank"><img src="./static/image/红楼梦模拟推演封面.jpg" alt="MiroFish デモ動画" width="75%"/></a>
+
+画像をクリックして、「紅楼夢」前80回の数十万字に基づくMiroFishの失われた結末の深層予測をご覧ください
+</div>
+
+> **金融予測**、**政治ニュース予測** などの事例を近日公開予定...
+
+## 🔄 ワークフロー
+
+1. **グラフ構築**：シード抽出 & 個体/集合記憶の注入 & GraphRAG構築
+2. **環境セットアップ**：エンティティ関係抽出 & ペルソナ生成 & エージェント設定注入
+3. **シミュレーション**：デュアルプラットフォーム並列シミュレーション & 予測要件の自動解析 & 動的時間記憶更新
+4. **レポート生成**：豊富なツールセットを持つReportAgentによるシミュレーション後環境との深いインタラクション
+5. **深層インタラクション**：シミュレーション世界の任意のエージェントとチャット & ReportAgentとの対話
+
+## 🚀 クイックスタート
+
+### オプション1：ソースコードデプロイ（推奨）
+
+#### 前提条件
+
+| ツール | バージョン | 説明 | インストール確認 |
+|------|---------|-------------|-------------------|
+| **Node.js** | 18+ | フロントエンドランタイム、npm含む | `node -v` |
+| **Python** | ≥3.11, ≤3.12 | バックエンドランタイム | `python --version` |
+| **uv** | 最新版 | Pythonパッケージマネージャー | `uv --version` |
+
+#### 1. 環境変数の設定
+
+```bash
+# サンプル設定ファイルをコピー
+cp .env.example .env
+
+# .envファイルを編集し、必要なAPIキーを入力
+```
+
+**必須環境変数：**
+
+```env
+# LLM API設定（OpenAI SDK形式の任意のLLM APIに対応）
+# 推奨：阿里雲百錬プラットフォーム経由のQwen-plusモデル: https://bailian.console.aliyun.com/
+# 消費量が多いため、まず40ラウンド未満のシミュレーションをお試しください
+LLM_API_KEY=your_api_key
+LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
+LLM_MODEL_NAME=qwen-plus
+
+# Zep Cloud設定
+# 無料の月間クォータで簡単な利用には十分です: https://app.getzep.com/
+ZEP_API_KEY=your_zep_api_key
+```
+
+#### 2. 依存関係のインストール
+
+```bash
+# すべての依存関係をワンクリックでインストール（ルート + フロントエンド + バックエンド）
+npm run setup:all
+```
+
+または段階的にインストール：
+
+```bash
+# Node依存関係をインストール（ルート + フロントエンド）
+npm run setup
+
+# Python依存関係をインストール（バックエンド、仮想環境を自動作成）
+npm run setup:backend
+```
+
+#### 3. サービスの起動
+
+```bash
+# フロントエンドとバックエンドを同時に起動（プロジェクトルートから実行）
+npm run dev
+```
+
+**サービスURL：**
+- フロントエンド: `http://localhost:3000`
+- バックエンド API: `http://localhost:5001`
+
+**個別に起動：**
+
+```bash
+npm run backend   # バックエンドのみ起動
+npm run frontend  # フロントエンドのみ起動
+```
+
+### オプション2：Dockerデプロイ
+
+```bash
+# 1. 環境変数を設定（ソースデプロイと同様）
+cp .env.example .env
+
+# 2. イメージをプルして起動
+docker compose up -d
+```
+
+デフォルトでルートディレクトリの `.env` を読み取り、ポート `3000（フロントエンド）/ 5001（バックエンド）` をマッピング
+
+> 高速プル用のミラーアドレスが `docker-compose.yml` にコメントとして記載されています。必要に応じて差し替えてください。
+
+## 📬 コミュニティに参加
+
+<div align="center">
+<img src="./static/image/QQ群.png" alt="QQグループ" width="60%"/>
+</div>
+
+&nbsp;
+
+MiroFishチームはフルタイム/インターンシップのポジションを募集しています。マルチエージェントシミュレーションやLLMアプリケーションに興味がある方は、お気軽に履歴書をお送りください：**mirofish@shanda.com**
+
+## 📄 謝辞
+
+**MiroFishは盛大グループから戦略的支援とインキュベーションを受けています！**
+
+MiroFishのシミュレーションエンジンは **[OASIS (Open Agent Social Interaction Simulations)](https://github.com/camel-ai/oasis)** を基盤としています。CAMEL-AIチームのオープンソース貢献に心より感謝いたします！
+
+## 📈 プロジェクト統計
+
+<a href="https://www.star-history.com/#666ghj/MiroFish&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=666ghj/MiroFish&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=666ghj/MiroFish&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=666ghj/MiroFish&type=date&legend=top-left" />
+ </picture>
+</a>

README.md

@@ -20,7 +20,7 @@
 [![X](https://img.shields.io/badge/X-Follow-000000?style=flat-square&logo=x&logoColor=white)](https://x.com/mirofish_ai)
 [![Instagram](https://img.shields.io/badge/Instagram-Follow-E4405F?style=flat-square&logo=instagram&logoColor=white)](https://www.instagram.com/mirofish_ai/)
 
-[English](./README-EN.md) | [中文文档](./README.md)
+[English](./README-EN.md) | [中文文档](./README.md) | [日本語](./README-JA.md)
 
 </div>