Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README-EN.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
[Tiếng Việt](./README-vi.md) | [English](./README-EN.md) | [中文文档](./README.md)

</div>

Expand Down
203 changes: 203 additions & 0 deletions README-vi.md
Original file line number Diff line number Diff line change
@@ -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>

Công cụ Trí tuệ Bầy đàn Đơn giản và Phổ quát, Dự đoán Mọi thứ
</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)](http://discord.gg/ePf5aPaHnA)
[![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/)

[Tiếng Việt](./README-vi.md) | [English](./README-EN.md) | [中文文档](./README.md)

</div>

## ⚡ Tổng quan dự án

**MiroFish** là một công cụ dự đoán AI thế hệ mới dựa trên công nghệ đa tác vụ (multi-agent). Bằng cách trích xuất thông tin "hạt giống" từ thế giới thực (như tin tức nóng hổi, dự thảo chính sách hoặc tín hiệu tài chính), nó tự động xây dựng một thế giới kỹ thuật số song song với độ trung thực cao. Trong không gian này, hàng ngàn tác nhân thông minh (agent) với tính cách độc lập, trí nhớ dài hạn và logic hành vi tự do tương tác và phát triển xã hội. Bạn có thể tác động đến các biến số từ "góc nhìn của Chúa" để suy luận chính xác các xu hướng tương lai — **diễn tập tương lai trong một hộp cát kỹ thuật số và đưa ra quyết định sau vô số lần mô phỏng**.

> Bạn chỉ cần: Tải lên tài liệu hạt giống (báo cáo phân tích dữ liệu hoặc các câu chuyện thú vị) và mô tả yêu cầu dự đoán bằng ngôn ngữ tự nhiên.</br>
> MiroFish sẽ trả về: Một báo cáo dự đoán chi tiết và một thế giới kỹ thuật số có độ trung thực cao có thể tương tác sâu.

### Tầm nhìn của chúng tôi

MiroFish tận tâm tạo ra một chiếc gương trí tuệ bầy đàn phản chiếu thực tế bằng cách nắm bắt sự trỗi dậy tập thể được kích hoạt bởi các tương tác cá nhân, chúng tôi phá vỡ các giới hạn của dự đoán truyền thống:

- **Ở cấp độ vĩ mô**: Chúng tôi là một phòng thí nghiệm diễn tập cho những người ra quyết định, cho phép các chính sách và quan hệ công chúng được thử nghiệm với rủi ro bằng không.
- **Ở cấp độ vi mô**: Chúng tôi là một hộp cát sáng tạo cho người dùng cá nhân — dù là suy luận kết thúc tiểu thuyết hay khám phá các kịch bản tưởng tượng, mọi thứ đều có thể thú vị, vui nhộn và dễ tiếp cận.

Từ những dự đoán nghiêm túc đến những mô phỏng vui chơi, chúng tôi để mọi "nếu như" đều thấy được kết quả, giúp dự đoán mọi thứ trở nên khả thi.

## 🌐 Bản demo trực tuyến

Chào mừng bạn đến thăm môi trường demo trực tuyến của chúng tôi và trải nghiệm mô phỏng dự đoán về các sự kiện dư luận xã hội mà chúng tôi đã chuẩn bị cho bạn: [mirofish-live-demo](https://666ghj.github.io/mirofish-demo/)

## 📸 Ảnh chụp màn hình

<div align="center">
<table>
<tr>
<td><img src="./static/image/Screenshot/运行截图1.png" alt="Screenshot 1" width="100%"/></td>
<td><img src="./static/image/Screenshot/运行截图2.png" alt="Screenshot 2" width="100%"/></td>
</tr>
<tr>
<td><img src="./static/image/Screenshot/运行截图3.png" alt="Screenshot 3" width="100%"/></td>
<td><img src="./static/image/Screenshot/运行截图4.png" alt="Screenshot 4" width="100%"/></td>
</tr>
<tr>
<td><img src="./static/image/Screenshot/运行截图5.png" alt="Screenshot 5" width="100%"/></td>
<td><img src="./static/image/Screenshot/运行截图6.png" alt="Screenshot 6" width="100%"/></td>
</tr>
</table>
</div>

## 🎬 Video Demo

### 1. Mô phỏng dư luận Đại học Vũ Hán + Giới thiệu dự án MiroFish

<div align="center">
<a href="https://www.bilibili.com/video/BV1VYBsBHEMY/" target="_blank"><img src="./static/image/武大模拟演示封面.png" alt="MiroFish Demo Video" width="75%"/></a>

Nhấp vào ảnh để xem video demo hoàn chỉnh dự đoán bằng cách sử dụng "Báo cáo dư luận Đại học Vũ Hán" do BettaFish tạo ra.
</div>

### 2. Mô phỏng kết thúc bị mất của Hồng Lâu Mộng

<div align="center">
<a href="https://www.bilibili.com/video/BV1cPk3BBExq" target="_blank"><img src="./static/image/红楼梦模拟推演封面.jpg" alt="MiroFish Demo Video" width="75%"/></a>

Nhấp vào ảnh để xem dự đoán sâu sắc của MiroFish về kết thúc bị mất dựa trên hàng trăm nghìn chữ từ 80 chương đầu tiên của "Hồng Lâu Mộng".
</div>

> **Dự đoán tài chính**, **Dự đoán tin tức chính trị** và nhiều ví dụ khác sẽ sớm ra mắt...

## 🔄 Quy trình làm việc

1. **Xây dựng bản đồ tri thức**: Trích xuất hạt giống thực tế & Tiêm trí nhớ cá nhân và tập thể & Xây dựng GraphRAG.
2. **Thiết lập môi trường**: Trích xuất quan hệ thực thể & Tạo nhân cách & Cấu hình môi trường Agent tiêm tham số mô phỏng.
3. **Bắt đầu mô phỏng**: Mô phỏng song song trên hai nền tảng & Tự động phân tích yêu cầu dự đoán & Cập nhật trí nhớ thời gian động.
4. **Tạo báo cáo**: ReportAgent với bộ công cụ phong phú để tương tác sâu với môi trường sau mô phỏng.
5. **Tương tác sâu**: Trò chuyện với bất kỳ tác nhân nào trong thế giới mô phỏng & Tương tác với ReportAgent.

## 🚀 Bắt đầu nhanh

### Lựa chọn 1: Triển khai từ mã nguồn (Khuyến nghị)

#### Điều kiện tiên quyết

| Công cụ | Phiên bản | Mô tả | Kiểm tra cài đặt |
|------|---------|-------------|-------------------|
| **Node.js** | 18+ | Môi trường chạy frontend, bao gồm npm | `node -v` |
| **Python** | ≥3.11, ≤3.12 | Môi trường chạy backend | `python --version` |
| **uv** | Mới nhất | Trình quản lý gói Python | `uv --version` |

#### 1. Cấu hình biến môi trường

```bash
# Sao chép tệp cấu hình ví dụ
cp .env.example .env

# Chỉnh sửa tệp .env và điền các khóa API cần thiết
```

**Các biến môi trường bắt buộc:**

```env
# Cấu hình LLM API (hỗ trợ bất kỳ LLM API nào với định dạng OpenAI SDK)
# Khuyến nghị: Mô hình Qwen-plus của Alibaba qua nền tảng Bailian: https://bailian.console.aliyun.com/
# Tiêu thụ cao, hãy thử mô phỏng với ít hơn 40 vòng trước
LLM_API_KEY=your_api_key
LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
LLM_MODEL_NAME=qwen-plus

# Cấu hình Zep Cloud
# Hạn ngạch miễn phí hàng tháng là đủ cho việc sử dụng đơn giản: https://app.getzep.com/
ZEP_API_KEY=your_zep_api_key
```

#### 2. Cài đặt phụ thuộc

```bash
# Cài đặt một lần cho tất cả các phụ thuộc (root + frontend + backend)
npm run setup:all
```

Hoặc cài đặt từng bước:

```bash
# Cài đặt phụ thuộc Node (root + frontend)
npm run setup

# Cài đặt phụ thuộc Python (backend, tự động tạo môi trường ảo)
npm run setup:backend
```

#### 3. Khởi động dịch vụ

```bash
# Khởi động cả frontend và backend (chạy từ thư mục gốc của dự án)
npm run dev
```

**Địa chỉ dịch vụ:**
- Frontend: `http://localhost:3000`
- Backend API: `http://localhost:5001`

**Khởi động riêng lẻ:**

```bash
npm run backend # Chỉ khởi động backend
npm run frontend # Chỉ khởi động frontend
```

### Lựa chọn 2: Triển khai Docker

```bash
# 1. Cấu hình biến môi trường (giống như triển khai mã nguồn)
cp .env.example .env

# 2. Kéo image và khởi động
docker compose up -d
```

Mặc định sẽ đọc `.env` từ thư mục gốc, ánh xạ các cổng `3000 (frontend) / 5001 (backend)`.

> Địa chỉ mirror để kéo nhanh hơn được cung cấp dưới dạng ghi chú trong `docker-compose.yml`, hãy thay thế nếu cần thiết.

## 📬 Tham gia thảo luận

<div align="center">
<img src="./static/image/QQ群.png" alt="QQ Group" width="60%"/>
</div>

&nbsp;

Đội ngũ MiroFish đang tuyển dụng các vị trí toàn thời gian/thực tập. Nếu bạn quan tâm đến mô phỏng đa tác vụ và ứng dụng LLM, vui lòng gửi CV của bạn đến: **mirofish@shanda.com**

## 📄 Lời cảm ơn

**MiroFish đã nhận được sự hỗ trợ chiến lược và ươm tạo từ Tập đoàn Shanda!**

Công cụ mô phỏng của MiroFish được cung cấp bởi **[OASIS (Open Agent Social Interaction Simulations)](https://github.com/camel-ai/oasis)**, Chúng tôi chân thành cảm ơn đội ngũ CAMEL-AI vì những đóng góp mã nguồn mở của họ!

## 📈 Thống kê dự án

<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>
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
[Tiếng Việt](./README-vi.md) | [English](./README-EN.md) | [中文文档](./README.md)

</div>

Expand Down
6 changes: 3 additions & 3 deletions frontend/index.html
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
<!doctype html>
<html lang="zh-CN">
<html lang="en">
<head>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@100..800&family=Noto+Sans+SC:wght@300;400;500;700;800;900&family=Space+Grotesk:wght@300..700&display=swap" rel="stylesheet">
<meta charset="UTF-8" />
<link rel="icon" type="image/png" href="/icon.png" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="description" content="MiroFish - 社交媒体舆论模拟系统" />
<title>MiroFish - 预测万物</title>
<meta name="description" content="MiroFish - Social Media Opinion Simulation System" />
<title>MiroFish</title>
</head>
<body>
<div id="app"></div>
Expand Down
70 changes: 66 additions & 4 deletions frontend/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions frontend/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@
"axios": "1.13.2",
"d3": "^7.9.0",
"vue": "^3.5.24",
"vue-i18n": "^9.14.5",
"vue-router": "^4.6.3"
},
"devDependencies": {
Expand Down
Loading