204 lines
9.7 KiB
Markdown
204 lines
9.7 KiB
Markdown
<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>Um Motor de Inteligência de Enxame Simples e Universal, Preveja Qualquer Coisa</em>
|
|
|
|
<a href="https://www.shanda.com/" target="_blank"><img src="./static/image/shanda_logo.png" alt="666ghj%2MiroFish | Shanda" height="40"/></a>
|
|
|
|
[](https://github.com/666ghj/MiroFish/stargazers)
|
|
[](https://github.com/666ghj/MiroFish/watchers)
|
|
[](https://github.com/666ghj/MiroFish/network)
|
|
[](https://hub.docker.com/)
|
|
[](https://deepwiki.com/666ghj/MiroFish)
|
|
|
|
[](http://discord.gg/ePf5aPaHnA)
|
|
[](https://x.com/mirofish_ai)
|
|
[](https://www.instagram.com/mirofish_ai/)
|
|
|
|
[English](./README.md) | [中文文档](./README-ZH.md) | [Português (Brasil)](./README-PT-BR.md) | [Português (Portugal)](./README-PT-PT.md)
|
|
|
|
</div>
|
|
|
|
## ⚡ Visão Geral
|
|
|
|
O **MiroFish** é um motor de previsão de IA de nova geração impulsionado por tecnologia multiagente. Ao extrair informação-semente do mundo real (como notícias de última hora, esboços de políticas ou sinais financeiros), constrói automaticamente um mundo digital paralelo de alta fidelidade. Dentro desse espaço, milhares de agentes inteligentes com personalidades independentes, memória de longo prazo e lógica comportamental interagem livremente e atravessam uma evolução social. Pode injetar variáveis dinamicamente com uma "visão divina" para deduzir trajetórias futuras com precisão — **ensaie o futuro num sandbox digital e vença decisões após inúmeras simulações**.
|
|
|
|
> Apenas precisa de: carregar materiais-semente (relatórios de análise de dados ou histórias interessantes) e descrever os seus requisitos de previsão em linguagem natural</br>
|
|
> O MiroFish devolverá: um relatório de previsão detalhado e um mundo digital interativo de alta fidelidade
|
|
|
|
### A Nossa Visão
|
|
|
|
O MiroFish está dedicado a criar um espelho de inteligência de enxame que mapeia a realidade. Ao capturar a emergência coletiva desencadeada por interações individuais, rompemos as limitações da previsão tradicional:
|
|
|
|
- **Ao Nível Macro**: somos um laboratório de ensaio para decisores, permitindo que políticas e relações públicas sejam testadas sem risco
|
|
- **Ao Nível Micro**: somos um sandbox criativo para utilizadores individuais — seja a deduzir finais de romances ou a explorar cenários imaginativos, tudo pode ser divertido, lúdico e acessível
|
|
|
|
Da previsão séria à simulação lúdica, deixamos que cada "e se" veja o seu desfecho, tornando possível prever qualquer coisa.
|
|
|
|
## 🌐 Demonstração Ao Vivo
|
|
|
|
Visite o nosso ambiente de demonstração online e experimente uma simulação de previsão sobre um evento de opinião pública em destaque que preparámos para si: [mirofish-live-demo](https://666ghj.github.io/mirofish-demo/)
|
|
|
|
## 📸 Capturas de Ecrã
|
|
|
|
<div align="center">
|
|
<table>
|
|
<tr>
|
|
<td><img src="./static/image/Screenshot/运行截图1.png" alt="Captura 1" width="100%"/></td>
|
|
<td><img src="./static/image/Screenshot/运行截图2.png" alt="Captura 2" width="100%"/></td>
|
|
</tr>
|
|
<tr>
|
|
<td><img src="./static/image/Screenshot/运行截图3.png" alt="Captura 3" width="100%"/></td>
|
|
<td><img src="./static/image/Screenshot/运行截图4.png" alt="Captura 4" width="100%"/></td>
|
|
</tr>
|
|
<tr>
|
|
<td><img src="./static/image/Screenshot/运行截图5.png" alt="Captura 5" width="100%"/></td>
|
|
<td><img src="./static/image/Screenshot/运行截图6.png" alt="Captura 6" width="100%"/></td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
|
|
## 🎬 Vídeos de Demonstração
|
|
|
|
### 1. Simulação de Opinião Pública da Universidade de Wuhan + Introdução ao Projeto MiroFish
|
|
|
|
<div align="center">
|
|
<a href="https://www.bilibili.com/video/BV1VYBsBHEMY/" target="_blank"><img src="./static/image/武大模拟演示封面.png" alt="Vídeo de Demonstração MiroFish" width="75%"/></a>
|
|
|
|
Clique na imagem para ver o vídeo de demonstração completo da previsão utilizando o "Relatório de Opinião Pública da Universidade de Wuhan" gerado pelo BettaFish
|
|
</div>
|
|
|
|
### 2. Simulação do Final Perdido de "Sonho da Câmara Vermelha"
|
|
|
|
<div align="center">
|
|
<a href="https://www.bilibili.com/video/BV1cPk3BBExq" target="_blank"><img src="./static/image/红楼梦模拟推演封面.jpg" alt="Vídeo de Demonstração MiroFish" width="75%"/></a>
|
|
|
|
Clique na imagem para ver a previsão profunda do MiroFish sobre o final perdido, baseada em centenas de milhares de palavras dos 80 primeiros capítulos de "Sonho da Câmara Vermelha"
|
|
</div>
|
|
|
|
> **Previsão Financeira**, **Previsão de Notícias Políticas** e mais exemplos em breve...
|
|
|
|
## 🔄 Fluxo de Trabalho
|
|
|
|
1. **Construção do Grafo**: extração de sementes, injeção de memória individual/coletiva e construção de GraphRAG
|
|
2. **Configuração do Ambiente**: extração de relações entre entidades, geração de personas e injeção de configuração de agentes
|
|
3. **Simulação**: simulação paralela em duas plataformas, análise automática de requisitos de previsão e atualizações dinâmicas de memória temporal
|
|
4. **Geração do Relatório**: ReportAgent com conjunto avançado de ferramentas para interação profunda com o ambiente pós-simulação
|
|
5. **Interação Profunda**: converse com qualquer agente do mundo simulado e dialogue com o ReportAgent
|
|
|
|
## 🚀 Início Rápido
|
|
|
|
### Opção 1: Implementação a Partir do Código-Fonte (Recomendado)
|
|
|
|
#### Pré-requisitos
|
|
|
|
| Ferramenta | Versão | Descrição | Verificar Instalação |
|
|
|------|---------|-------------|-------------------|
|
|
| **Node.js** | 18+ | Runtime do frontend, inclui npm | `node -v` |
|
|
| **Python** | ≥3.11, ≤3.12 | Runtime do backend | `python --version` |
|
|
| **uv** | Mais recente | Gestor de pacotes Python | `uv --version` |
|
|
|
|
#### 1. Configurar Variáveis de Ambiente
|
|
|
|
```bash
|
|
# Copie o ficheiro de configuração de exemplo
|
|
cp .env.example .env
|
|
|
|
# Edite o ficheiro .env e preencha as chaves de API necessárias
|
|
```
|
|
|
|
**Variáveis de Ambiente Obrigatórias:**
|
|
|
|
```env
|
|
# Configuração da API do LLM (suporta qualquer API de LLM no formato do SDK da OpenAI)
|
|
# Recomendado: modelo Alibaba Qwen-plus via Bailian Platform: https://bailian.console.aliyun.com/
|
|
# Consumo elevado, experimente primeiro simulações com menos de 40 rondas
|
|
LLM_API_KEY=a_sua_chave_api
|
|
LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
|
|
LLM_MODEL_NAME=qwen-plus
|
|
|
|
# Configuração do Zep Cloud
|
|
# A quota mensal gratuita é suficiente para uso simples: https://app.getzep.com/
|
|
ZEP_API_KEY=a_sua_chave_api_zep
|
|
```
|
|
|
|
#### 2. Instalar Dependências
|
|
|
|
```bash
|
|
# Instalação de todas as dependências num só comando (raiz + frontend + backend)
|
|
npm run setup:all
|
|
```
|
|
|
|
Ou instale passo a passo:
|
|
|
|
```bash
|
|
# Instalar dependências Node (raiz + frontend)
|
|
npm run setup
|
|
|
|
# Instalar dependências Python (backend, cria ambiente virtual automaticamente)
|
|
npm run setup:backend
|
|
```
|
|
|
|
#### 3. Iniciar os Serviços
|
|
|
|
```bash
|
|
# Iniciar frontend e backend (execute a partir da raiz do projeto)
|
|
npm run dev
|
|
```
|
|
|
|
**URLs dos Serviços:**
|
|
- Frontend: `http://localhost:3000`
|
|
- API do Backend: `http://localhost:5001`
|
|
|
|
**Iniciar Individualmente:**
|
|
|
|
```bash
|
|
npm run backend # Inicia apenas o backend
|
|
npm run frontend # Inicia apenas o frontend
|
|
```
|
|
|
|
### Opção 2: Implementação com Docker
|
|
|
|
```bash
|
|
# 1. Configurar variáveis de ambiente (igual à implementação por código-fonte)
|
|
cp .env.example .env
|
|
|
|
# 2. Transferir a imagem e iniciar
|
|
docker compose up -d
|
|
```
|
|
|
|
Lê `.env` do diretório raiz por predefinição e mapeia as portas `3000 (frontend) / 5001 (backend)`
|
|
|
|
> O endereço do espelho para transferência mais rápida está fornecido como comentários em `docker-compose.yml`, substitua se necessário.
|
|
|
|
## 📬 Junte-se à Conversa
|
|
|
|
<div align="center">
|
|
<img src="./static/image/QQ群.png" alt="Grupo QQ" width="60%"/>
|
|
</div>
|
|
|
|
|
|
|
|
A equipa MiroFish está a recrutar para posições a tempo inteiro/estágio. Se tem interesse em simulação multiagente e aplicações de LLM, envie o seu currículo para: **mirofish@shanda.com**
|
|
|
|
## 📄 Agradecimentos
|
|
|
|
**O MiroFish recebeu apoio estratégico e incubação do Shanda Group!**
|
|
|
|
O motor de simulação do MiroFish é impulsionado pelo **[OASIS (Open Agent Social Interaction Simulations)](https://github.com/camel-ai/oasis)**. Agradecemos sinceramente à equipa CAMEL-AI pelas suas contribuições de código aberto!
|
|
|
|
## 📈 Estatísticas do Projeto
|
|
|
|
<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>
|