O kit de desenvolvimento de software (SDK) do Optimization Solver, chamado MindOpt, é um solver local que você executa na própria máquina. Esta página explica como baixe o pacote correto para sua plataforma, instale-o, configure uma licença e adicionar suporte a Java ou Python.
Ao baixe o SDK, você concorda com os Alibaba Cloud International Website Terms of Use.
Instalação rápida apenas para Python ou Java
Se precisar apenas da biblioteca Python, instale-a com pip:
pip install mindoptpy
Para usar apenas a biblioteca Java (V2.1 e posteriores), adicione uma dependência Maven ao seu pom.xml. Consulte Instalar suporte a Java para ver as opções de classificador.
Ambas as abordagens dispensam a instalação completa. Para usar o solver de linha de comando, as APIs C, C++, C# ou MATLAB, ou múltiplas APIs de linguagem simultaneamente, baixe o pacote de instalação completo descrito abaixo.
Pré-requisitos
Antes de começar, verifique se você tem:
Um sistema operacional compatível (consulte Requisitos do sistema)
Acesso de administrador ou permissão de gravação suficiente na máquina de destino
Uma conta Alibaba Cloud (necessária para autenticação em cloud)
Baixe o SDK
Versão mais recente: V2.3.0 (lançada em 02/02/2026).
As APIs das versões V0.x e V2.x são majoritariamente incompatíveis. Consulte a documentação da API correspondente à versão instalada.
Plataforma | Arquitetura | V2.3.0 | V0.25.1 |
Linux | linux64x86 | Arquivo: | Arquivo: |
linux64aarch | Arquivo: | Arquivo: | |
Windows | windows64 | Arquivo: | Arquivo: |
macOS | osx64x86 (Intel) | Arquivo: | Arquivo: |
osx64aarch (Apple Silicon) | Arquivo: | Arquivo: |
Para logs de alterações e versões anteriores, consulte Download history.
Requisitos do sistema
Sistema operacional
|
Sistema operacional |
Versão mínima |
|
Windows |
Windows 10 ou posterior |
|
Linux x86_64 |
Glibc >= 2,14 |
|
Linux aarch64 |
Glibc >= 2,17 |
|
macOS x86_64 |
macOS 11.0 ou posterior |
|
macOS arm64 |
macOS 12.0 ou posterior |
Versões de linguagem e compilador
|
Linguagem |
Versões/compiladores compatíveis |
|
C |
Visual Studio 2019 ou posterior, GCC 4.9 ou posterior, Clang++ |
|
C++ |
Visual Studio 2019 ou posterior, GCC 4.9 ou posterior, Clang++ |
|
C# |
.NET SDK 8.0 ou posterior |
|
Python |
3,8, 3,9, 3,10, 3,11, 3,12, 3,13 |
|
Java |
JDK 1.8 ou posterior |
|
MATLAB |
MATLAB 2021b ou posterior |
Instale o SDK
Antes da instalação, remova ou faça backup de qualquer versão anterior. Consulte Uninstall and reinstall.
Você também pode acompanhar o Video overview.
Windows
Clique duas vezes no arquivo de instalação .msi e siga as instruções na tela.
Para instale para todos os usuários, execute o Prompt de Comando como administrador, acesse a pasta que contém o instalador e execute o arquivo.
Linux
Não sabe qual arquitetura possui? Execute uname -m. A saída x86_64 indica o uso do instalador x86; já aarch64 indica o instalador ARM.
Execute o comando abaixo e siga as instruções:
# x86_64 systems
bash mindopt-install-linux64x86-2.3.0.sh
# ARM (aarch64) systems
bash mindopt-install-linux64aarch-2.3.0.sh
docker
Adicione o seguinte conteúdo ao seu Dockerfile:
# The admin user is used as an example.
RUN cd /home/admin/mindopt/ && \
bash mindopt-install-linux64x86-2.3.0.sh --target /home/admin/mindopt && \
rm -rf mindopt-install-linux64x86-2.3.0.sh
# Set the MindOpt environment variables.
ENV MINDOPT_HOME /home/admin/mindopt/2.3.0
ENV PATH $MINDOPT_HOME/linux64-x86/bin:$PATH
ENV LD_LIBRARY_PATH $MINDOPT_HOME/linux64-x86/lib:$LD_LIBRARY_PATH
Apenas para instalações docker da versão V0.x.x, adicione também:
# MDO_NATIVE_LIBRARY is required for the Java SDK in V0.x.x. Not needed for V1.0.0 or later.
ENV MDO_NATIVE_LIBRARY $MINDOPT_HOME/linux64-x86/lib/libmindopt.so.0.25.1
macOS
Execute o comando abaixo e siga as instruções:
# Intel (x86_64) systems
bash mindopt-install-osx64x86-2.3.0.sh
# Apple Silicon (arm64) systems
bash mindopt-install-osx64aarch-2.3.0.sh
Estrutura de diretórios após a instalação
Após a conclusão da instalação, o diretório conterá os seguintes itens:
|
Caminho |
Descrição |
|
|
Pasta raiz nomeada conforme a versão instalada. Várias versões podem coexistir no mesmo diretório pai. |
|
|
Subpasta com executáveis, bibliotecas de link dinâmico e arquivos relacionados. O nome reflete o sistema operacional e a arquitetura: |
|
|
Exemplos de código para várias linguagens, ferramentas de modelagem e dados de entrada de amostra na subpasta |
|
|
Arquivo |
|
|
Arquivo de autenticação criado na próxima etapa. |

Verifique a instalação
Verifique as variáveis de ambiente
Windows: O instalador adiciona MINDOPT_HOME e Path automaticamente. Para alternar entre versões instaladas, atualize o valor de MINDOPT_HOME.

Linux e macOS: O instalador adiciona source ~/.mdo_profile aos arquivos ~/.bashrc e ~/.zshrc. As alterações entram em vigor após reiniciar o terminal.
Para aplicá-las imediatamente sem reiniciar:
cat ~/.mdo_profile # view the current settings
source ~/.mdo_profile
Para alternar entre versões instaladas, edite diretamente o arquivo ~/.mdo_profile:
nano ~/.mdo_profile
Em um container docker, use export para verificar as variáveis.
Execute um teste rápido
Após carregar as variáveis de ambiente, execute mindopt na linha de comando:
mindopt
Uma instalação bem-sucedida exibe informações de versão e uso no terminal, semelhante à saída mostrada aqui:

Solução de problemas
Erro de permissão: Se mindopt falhar ao executar, corrija a permissão do executável:
# Linux
chmod u+x $MINDOPT_HOME/linux64-x86/bin/mindopt
# macOS
chmod u+x $MINDOPT_HOME/osx64-x86/bin/mindopt
Bloqueio de segurança do macOS: O macOS pode impedir a execução do binário devido a verificações de segurança do desenvolvedor. Em Security & Privacy, clique em Allow Anyway.

Para outros problemas, consulte a seção Installation issues no FAQ.
Configure uma licença
O MindOpt requer um arquivo de licença para funcionar. Escolha um dos dois métodos de autenticação:
|
Autenticação em cloud (recomendada) |
Autenticação offline |
|
|
Como funciona |
Chave de licença vinculada à sua conta Alibaba Cloud; internet necessária apenas para autenticação |
Arquivo de licença vinculado a um ID de máquina específico; totalmente offline |
|
Mais indicado para |
Maioria dos usuários; especialmente ao usar em múltiplas máquinas |
Ambientes isolados ou implantações em máquina única |
|
Múltiplas máquinas |
Uma chave funciona em várias máquinas |
Apenas máquina única |
|
Renovação |
Renove no console sem alterar o arquivo de licença; lembrete por SMS antes do vencimento |
Compra de nova licença |
Durante a autenticação, o MindOpt busca primeiro o arquivomindopt.lice depois ofl_client.ini, com base nas configurações das variáveis de ambiente. Ele valida o primeiro arquivo encontrado. Os nomes dos arquivos de licença são fixos e não podem ser alterados.
Opção 1: Autenticação em cloud (recomendada)
Siga as etapas em Configure an Alibaba Cloud account for authentication para obter uma chave de licença e crie o arquivo de licença fl_client.ini. O solver executa localmente na sua máquina. A conexão com a internet é necessária apenas para autenticação — nenhuma outra informação é enviada.
Opção 2: Autenticação offline
A partir de 2024, o console oferecerá suporte à aquisição de licença de autenticação local para modo standalone offline com concorrência ilimitada. Para mais detalhes, consulte Get a machine fingerprint for the unnetworked single machine unlimited concurrency license.
Defina o local do arquivo de licença
Recomendado: Defina a variável de ambiente MINDOPT_LICENSE_PATH para a pasta que contém o arquivo de licença.
Linux e macOS:
export MINDOPT_LICENSE_PATH=$HOME/mindopt
Windows — defina a variável de ambiente nas Propriedades do Sistema:

Para mais detalhes, consulte License configuration.
Local padrão (se MINDOPT_LICENSE_PATH não estiver definido):
|
SO |
Caminho padrão |
|
Windows |
|
|
Linux |
|
|
macOS |
|
Instale o suporte a Java
Conclua a instalação base acima antes de instale o suporte a Java. O SDK Java depende das bibliotecas de link dinâmico do solver.
Escolha o método correspondente à versão do seu SDK:
V2.1 e posteriores — Dependência Maven (recomendada)
Adicione a seguinte dependência ao seu pom.xml. Defina o classifier para corresponder à sua plataforma:
<dependency>
<groupId>com.alibaba.damo</groupId>
<artifactId>mindoptj</artifactId>
<version>2.1.0-SNAPSHOT</version>
<classifier>osx-x64</classifier>
<!-- macOS arm64 : osx-aarch -->
<!-- linux arm64 : linux-aarch -->
<!-- linux x86 : linux-x64 -->
<!-- windows : win-x64 -->
<!-- all platforms: portable -->
<type>jar</type>
</dependency>
V1.0 e posteriores — JAR integrado
O pacote de instalação inclui mindoptj.jar em <MDOHOME>/<VERSION>/<PLATFORM>/lib/mindoptj.jar. Referencie-o diretamente no pom.xml:
<dependency>
<groupId>com.alibaba.damo</groupId>
<artifactId>mindoptj</artifactId>
<version>2.0.0</version>
<scope>system</scope>
<systemPath>${env.MINDOPT_HOME}/osx64-x86/lib/mindoptj.jar</systemPath>
</dependency>
V0.x.x — Dependência Maven
<dependency>
<groupId>com.alibaba.damo</groupId>
<artifactId>mindoptj</artifactId>
<version>[0.24.0, 1.0.0)</version>
</dependency>
Algumas IDEs (por exemplo, CLion) bloqueiam variáveis de ambiente relacionadas a rpath durante a execução, causando erros quando o programa busca bibliotecas dinâmicas. Especifique o caminho da biblioteca manualmente na configuração de execução da sua IDE. Para CLion no macOS, adicione o seguinte em Run/Debug Configurations: DYLD_LIBRARY_PATH=<MDOHOME>/<VERSION>/<PLATFORM>/lib
Instale o suporte a Python
A partir da V0.24.1, o comando pip install mindoptpy fornece uma biblioteca Python independente com licença inclusa (válida de 01/01/2023 a 28/02/2025). Esta instalação inclui apenas a biblioteca Python — não contempla o solver de linha de comando, APIs C/C++ ou ferramentas de modelagem. Para esses recursos, conclua a instalação completa acima.
Após a instalação completa, acesse a pasta da biblioteca Python e instale-a:
cd <MDOHOME>/<VERSION>/<PLATFORM>/lib/python
pip install .
A partir da V2.1, Python 3.6 e 3.7 não são mais suportados. Para soluções de erros de importação do módulo mindoptpy ou instruções detalhadas de instalação, consulte o Guia do Usuário .
Desinstale e reinstale
Desinstalação
Windows: Acesse Control Panel > Programs and Features, localize a versão do MindOpt e clique em com o botão direito para desinstalar. Cada versão instalada aparece como uma entrada separada. Se você instalou como administrador, o desinstalador pode não ter permissão para remover as variáveis de ambiente MINDOPT_HOME e Path — remova-as manualmente ou execute o desinstalador como administrador.
Linux e macOS:
Exclua o diretório de instalação (por exemplo,
$HOME/mindopt).Remova a linha
source ~/.mdo_profiledos arquivos~/.bashrce~/.zshrc, e então exclua~/.mdo_profile.
APIs Python:
pip3 uninstall mindoptpy
Se planeja reinstalar posteriormente, faça backup dos seus arquivos de licença antes de exclua o diretório de instalação. Locais padrão de licença:$HOME/mindopt(Linux/macOS) eC:\Users\<username>\mindopt(Windows). A execução de comandos de exemplo pode gerar arquivos de resultado.base.solno diretório de instalação — exclua-os conforme necessário.
Reinstalação
Várias versões do SDK podem coexistir em pastas separadas. Defina as variáveis de ambiente para a versão desejada — nenhuma alteração no arquivo de licença é necessária.
Windows: Clique duas vezes no instalador. As novas configurações de variáveis de ambiente substituem as anteriores. Para alternar entre versões, atualize o diretório na variável de ambiente MINDOPT_HOME.
Linux e macOS: Siga as etapas de instalação acima. Em seguida, atualize o caminho da versão em ~/.mdo_profile ou em ~/.bashrc/~/.zshrc.
Após reinstalar, feche e reabra a janela do prompt de comando para que as novas variáveis de ambiente entrem em vigor.
Próximos passos
Novo no MindOpt? Siga o Quick example of problem-solving no guia de Primeiros Passos.
Para a documentação completa do solver, consulte o Solver User Manual.