From 6bdcb0fc7c1694034a920087e5c2aa851306ad6b Mon Sep 17 00:00:00 2001 From: Pedro Renan Date: Sat, 25 Apr 2026 15:57:14 +0100 Subject: [PATCH] docs(i18n): add Portuguese READMEs and language navigation Add README-PT-BR.md and README-PT-PT.md alongside the existing English and Chinese versions. Update navigation links across all 4 README files so users can switch between language variants. --- README-PT-BR.md | 203 ++++++++++++++++++++++++++++++++++++++++++++++++ README-PT-PT.md | 203 ++++++++++++++++++++++++++++++++++++++++++++++++ README-ZH.md | 2 +- README.md | 2 +- 4 files changed, 408 insertions(+), 2 deletions(-) create mode 100644 README-PT-BR.md create mode 100644 README-PT-PT.md diff --git a/README-PT-BR.md b/README-PT-BR.md new file mode 100644 index 00000000..34c5f4a1 --- /dev/null +++ b/README-PT-BR.md @@ -0,0 +1,203 @@ +
+ +MiroFish Logo + +666ghj%2FMiroFish | Trendshift + +简洁通用的群体智能引擎，预测万物 +
+Um Motor de Inteligência de Enxame Simples e Universal, Preveja Qualquer Coisa + +666ghj%2MiroFish | Shanda + +[![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/) + +[English](./README.md) | [中文文档](./README-ZH.md) | [Português (Brasil)](./README-PT-BR.md) | [Português (Portugal)](./README-PT-PT.md) + +
+ +## ⚡ Visão Geral + +O **MiroFish** é um motor de previsão de IA de nova geração impulsionado por tecnologia multiagente. Ao extrair informações-semente do mundo real (como notícias de última hora, rascunhos de políticas ou sinais financeiros), ele 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 passam por uma evolução social. Você pode injetar variáveis dinamicamente com uma "visão divina" para deduzir trajetórias futuras com precisão — **ensaie o futuro em um sandbox digital e vença decisões após inúmeras simulações**. + +> Você só precisa: enviar materiais-semente (relatórios de análise de dados ou histórias interessantes) e descrever seus requisitos de previsão em linguagem natural
+> O MiroFish retornará: um relatório de previsão detalhado e um mundo digital interativo de alta fidelidade + +### Nossa Visão + +O MiroFish é 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: + +- **No Nível Macro**: somos um laboratório de ensaio para tomadores de decisão, permitindo que políticas e relações públicas sejam testadas sem risco +- **No Nível Micro**: somos um sandbox criativo para usuários individuais — seja deduzindo finais de romances ou explorando 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 seu desfecho, tornando possível prever qualquer coisa. + +## 🌐 Demonstração Ao Vivo + +Visite nosso ambiente de demonstração online e experimente uma simulação de previsão sobre um evento de opinião pública em alta que preparamos para você: [mirofish-live-demo](https://666ghj.github.io/mirofish-demo/) + +## 📸 Capturas de Tela + +
+ + + + + + + + + + + + + +
Captura 1Captura 2
Captura 3Captura 4
Captura 5Captura 6
+
+ +## 🎬 Vídeos de Demonstração + +### 1. Simulação de Opinião Pública da Universidade de Wuhan + Introdução ao Projeto MiroFish + +
+Vídeo de Demonstração MiroFish + +Clique na imagem para assistir ao vídeo de demonstração completo da previsão usando o "Relatório de Opinião Pública da Universidade de Wuhan" gerado pelo BettaFish +
+ +### 2. Simulação do Final Perdido de "Sonho da Câmara Vermelha" + +
+Vídeo de Demonstração MiroFish + +Clique na imagem para assistir à 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" +
+ +> **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: Implantaçã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 | Gerenciador de pacotes Python | `uv --version` | + +#### 1. Configurar Variáveis de Ambiente + +```bash +# Copie o arquivo de configuração de exemplo +cp .env.example .env + +# Edite o arquivo .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 alto, experimente primeiro simulações com menos de 40 rodadas +LLM_API_KEY=sua_chave_api +LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1 +LLM_MODEL_NAME=qwen-plus + +# Configuração do Zep Cloud +# A cota mensal gratuita é suficiente para uso simples: https://app.getzep.com/ +ZEP_API_KEY=sua_chave_api_zep +``` + +#### 2. Instalar Dependências + +```bash +# Instalação de todas as dependências em um 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: Implantação com Docker + +```bash +# 1. Configurar variáveis de ambiente (igual à implantação do código-fonte) +cp .env.example .env + +# 2. Baixar a imagem e iniciar +docker compose up -d +``` + +Lê `.env` do diretório raiz por padrão e mapeia as portas `3000 (frontend) / 5001 (backend)` + +> O endereço de espelho para download mais rápido está fornecido como comentários em `docker-compose.yml`, substitua se necessário. + +## 📬 Participe da Conversa + +
+Grupo QQ +
+ +  + +A equipe MiroFish está contratando para posições full-time/estágio. Se você tem interesse em simulação multiagente e aplicações de LLM, envie 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 à equipe CAMEL-AI por suas contribuições de código aberto! + +## 📈 Estatísticas do Projeto + + + + + + Star History Chart + + diff --git a/README-PT-PT.md b/README-PT-PT.md new file mode 100644 index 00000000..062bab95 --- /dev/null +++ b/README-PT-PT.md @@ -0,0 +1,203 @@ +
+ +MiroFish Logo + +666ghj%2FMiroFish | Trendshift + +简洁通用的群体智能引擎，预测万物 +
+Um Motor de Inteligência de Enxame Simples e Universal, Preveja Qualquer Coisa + +666ghj%2MiroFish | Shanda + +[![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/) + +[English](./README.md) | [中文文档](./README-ZH.md) | [Português (Brasil)](./README-PT-BR.md) | [Português (Portugal)](./README-PT-PT.md) + +
+ +## ⚡ 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
+> 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ã + +
+ + + + + + + + + + + + + +
Captura 1Captura 2
Captura 3Captura 4
Captura 5Captura 6
+
+ +## 🎬 Vídeos de Demonstração + +### 1. Simulação de Opinião Pública da Universidade de Wuhan + Introdução ao Projeto MiroFish + +
+Vídeo de Demonstração MiroFish + +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 +
+ +### 2. Simulação do Final Perdido de "Sonho da Câmara Vermelha" + +
+Vídeo de Demonstração MiroFish + +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" +
+ +> **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 + +
+Grupo QQ +
+ +  + +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 + + + + + + Star History Chart + + diff --git a/README-ZH.md b/README-ZH.md index 0b20424d..7ab8cddb 100644 --- a/README-ZH.md +++ b/README-ZH.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.md) | [中文文档](./README-ZH.md) +[English](./README.md) | [中文文档](./README-ZH.md) | [Português (Brasil)](./README-PT-BR.md) | [Português (Portugal)](./README-PT-PT.md) diff --git a/README.md b/README.md index 4b8369f4..ac39bbfa 100644 --- a/README.md +++ b/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.md) | [中文文档](./README-ZH.md) +[English](./README.md) | [中文文档](./README-ZH.md) | [Português (Brasil)](./README-PT-BR.md) | [Português (Portugal)](./README-PT-PT.md)