Pré-requisitos do Ambiente

Antes de prosseguir com a configuração do Manifold, certifique-se de que seu ambiente de desenvolvimento atenda aos seguintes requisitos mínimos:

• Python versão 3.6 ou superior
• Node.js versão 12.x ou superior, acompanhado de npm ou yarn
• Jupyter Notebook (opcional, para sessões interativas de análise)

O gerenciamento de dependências é dividido entre o ecossistema Python e o JavaScript.

Passo 1: Clonagem do Repositório e Instalação Base

Inicie o processo baixando o código-fonte oficial e navegando até o diretório raiz do projeto:

git clone https://gitcode.com/gh_mirrors/mani/manifold.git
cd manifold

Em seguida, instale as dependências fundamentais utilizando os gerenciadores de pacotes adequados:

# Configuração do ambiente Python
pip install -r requirements.txt

# Configuração do ambiente JavaScript
npm install
# Alternativamente, com yarn:
yarn install

Para configurar especificamente a interface web de demonstração, execute:

yarn install:all  # Instalação completa
# ou apenas para a web:
yarn install:web

Passo 2: Compilação dos Componentes Principais

Módulos Python

Compile e instale o núcleo da aplicação em Python através do script de setup:

python setup.py install

Na primeira execução, é necessário registrar a extensão no Jupyter:

jupyter nbextension install --py --symlink --sys-prefix mlvis

Módulos JavaScript

Os componentes de front-end podem ser instalados de forma modular. Parra o pacote principal e suas dependências de estilo:

npm install @mlvis/manifold styled-components styletron-engine-atomic styletron-react

Para adicionar o componente de calendário empilhado:

npm install @mlvis/stacked-calendar
# ou
yarn add @mlvis/stacked-calendar

Passo 3: Validação e Execução Inicial

Verificação da Integridade

Gere os pacotes de distribuição para garantir que a compilação foi bem-sucedida:

python setup.py sdist bdist_wheel

Integração com Jupyter

Inicie o servidor do Jupyter Notebook a partir do diretório do projeto:

jupyter notebook

Dentro de uma célula do notebook, execute o seguinte script para validar a importação e verificar a versão instalada:

import mlvis as manifold_debugger
current_release = manifold_debugger.__version__
print(f"Ambiente Manifold inicializado com sucesso. Versão detectada: {current_release}")

Resolução de Problemas Comuns

• Extensão do Jupyter não carrega: Force a ativação manual do plugin.

jupyter nbextension enable mlvis --py --sys-prefix

• Conflitos de dependências: Isole o projeto utilizando um amibente virtual.

python -m venv .manifold_env
source .manifold_env/bin/activate  # Linux/macOS
.manifold_env\Scripts\activate     # Windows

• Erros de renderização de estilo: O Manifold utiliza o Styletron. Certifique-se de que o Provider do Styletron está corretamente envolvido na sua aplicação React.