Ajuda para trabalhar com MQL5 Algo Forge

  1. Por que usar o Algo Forge
  2. Autorização
  3. Busca e exploração de projetos
  4. Início do trabalho com um projeto a partir do editor
    • 4.1. Conexão a um existente
    • 4.2. Criação de um novo repositório
  5. Links úteis

1. Por que usar o Algo Forge

O MQL5 Algo Forge é um hub online para trabalhar com projetos em MQL5, integrado diretamente ao MetaEditor e baseado no sistema de controle de versões Git. A principal missão do Algo Forge é oferecer aos desenvolvedores de estratégias algorítmicas o mesmo que o GitHub trouxe para o mundo open-source:

  • Gerenciamento confiável de versões
    O Git armazena o histórico localmente, por isso commits, alternância entre branches e visualização de mudanças são mais rápidos e estão disponíveis mesmo offline.

  • Branches e merges práticos
    Crie branches separados para ideias experimentais e una-os à versão principal sem conflitos desnecessários.

  • Portal único de projetos
    No forge.mql5.io você pode visualizar a estrutura de arquivos, commits, branches, participantes e tarefas de cada repositório, tudo no navegador, sem depender de serviços externos.

  • Rede social para traders-desenvolvedores
    Siga autores interessantes, forme equipes, discuta alterações diretamente no código e acompanhe a contribuição de cada participante.

  • Integração direta com o MetaEditor
    Comandos integrados ao MetaEditor permitem clonar, commitar e fazer push sem usar a linha de comando; tudo funciona de forma familiar, "direto do editor em um clique".

  • Aprendizado e troca de experiências
    Repositórios abertos permitem estudar soluções de outros desenvolvedores, adotar melhores práticas e rapidamente lançar seus próprios forks.

O Algo Forge transforma o desenvolvimento de robôs de negociação de uma atividade solitária em uma prática colaborativa, com infraestrutura Git prática, histórico de alterações transparente e uma comunidade ativa, exatamente o que é necessário para projetos de grande porte e qualidade no trading algorítmico.

2. Autorização

Para trabalhar com o portal Algo Forge é possível autenticar-se de duas formas, cada uma oferecendo possibilidades próprias.

2.1 No portal forge.mql5.io

  1. Na página inicial do forge.mql5.io, insira as credenciais da sua conta MQL5 e faça login.
    O portal utiliza a conta única da MQL5.community, por isso não é necessário criar logins adicionais. Se ainda não possui conta, crie um Login, insira seu email e registre-se clicando em "Sign Up". Essa combinação de login/senha será usada em todos os serviços MQL5, incluindo Market, VPS e Signals.

    Certifique-se de que os cookies estão habilitados no navegador, caso contrário, o login não será realizado.


  2. Após a autenticação, você será direcionado imediatamente para o feed pessoal de projetos. Ali, poderá visualizar sua atividade e acessar todos os repositórios aos quais está conectado, incluindo os pessoais e os compartilhados. 


    Quer ver o código de outros desenvolvedores? Vá até a aba Explore: lá você encontrará repositórios públicos, botões Star e Fork, lista de contribuidores e histórico de commits, isto é, tudo como no GitHub tradicional, só que para MQL5.

2.2 Autorização no MetaEditor (ambiente de desenvolvimento de estratégias para MetaTrader 5)

Para ter acesso aos mesmos repositórios diretamente pela IDE, basta vincular o MetaEditor à sua conta MQL5 uma única vez:

  1. Abra o MetaEditor e vá em Tools → Options → Community. 
    A aba chama-se MQL5.community, e aqui o editor solicita suas credenciais.

  2. Digite o Login (nome de usuário, não o email) e o Password, depois clique em OK. A senha é criptografada e armazenada localmente, de modo que não será necessário digitá-la todas as vezes.

  3. Após a autenticação no MetaEditor, todos os recursos Git para trabalhar com o portal Algo Forge ficam disponíveis.


Em resumo: uma conta MQL5.community = dois cliques para entrar no site e no MetaEditor. A partir daí, todo o conjunto de funcionalidades Git e de colaboração já está disponível "pronto para uso", permitindo programar, fazer commits e compartilhar projetos sem sair do ambiente de desenvolvimento habitual.

  1. A seção Explore contém um catálogo de projetos abertos, com opções de ordenação e aplicação de filtros por diversos parâmetros. A barra de pesquisa permite buscar projetos, desenvolvedores e organizações.


  2. Watch/Star — recebimento de notificações sobre novos commits, tarefas e releases.

    Um dos principais benefícios de participar no portal Algo Forge é a possibilidade de interagir ativamente com projetos de interesse. 





    Watch — assinatura de atualizações de um projeto

    • Finalidade: receber notificações sobre eventos em um repositório.

    • Quando você clica em Watch, o sistema envia notificações (normalmente por email ou via notificações integradas) sobre novos issues, pull requests, releases e outras atividades.

    Assim, o Watch é útil se você participa ativamente no desenvolvimento de um projeto ou deseja acompanhar suas atualizações.


    Star — adicionar o projeto aos favoritos, demonstrando interesse ou apoio

    • Finalidade: marcar um projeto como interessante ou relevante.

    • Ao clicar em Star, você não recebe notificações; é mais um gesto de reconhecimento ao autor e uma forma de adicionar o repositório à sua lista de favoritos.

    • Normalmente, as "estrelas" servem como indicador de popularidade de um projeto: quanto mais estrelas, mais pessoas o consideram útil.

    • Você também poderá encontrar facilmente esse projeto depois na seção Starred repositories do seu perfil.




  3. A barra de pesquisa aceita o nome do projeto, tópicos de discussão ou o autor.



  4. A página de um projeto exibe a árvore de arquivos (<> Code), o gráfico de commits (Commit graph), as branches (Branches), a contribuição dos participantes (Contributors) e o feed de atividades (Activity). 

4. Início do trabalho com um projeto a partir do MetaEditor

No site MQL5 Algo Forge você pode clonar o projeto de outro desenvolvedor, criando sua própria cópia. Isso é feito pelo botão Fork na página do projeto escolhido. Essa operação cria um repositório separado na sua conta. Para isso, entre no site https://forge.mql5.io usando os dados da sua conta MQL5, vá até a seção de projetos públicos (Explore) e encontre o projeto desejado. Quais as vantagens dessa operação em comparação com uma simples cópia:


4.1 Clonando o projeto de outro desenvolvedor

No forge.mql5.io, entre no projeto que deseja clonar e execute o comando Fork. Preencha o nome do fork a ser criado, adicione uma descrição e salve as alterações:



Depois, abra o MetaEditor com a mesma conta MQL5 e use o comando Refresh no Navegador.  Na pasta Shared Projects, aparecerá o projeto clonado. Em seguida, carregue-o a partir do portal Algo Forge usando o comando Git Clone. Você fará o download não apenas de todos os arquivos do projeto, mas também de todo o histórico de commits e de todas as branches do repositório. Assim, poderá continuar o trabalho no fork tendo em mãos todo o histórico do projeto clonado. 


Após concluir o clone, verifique o seu projeto: clique com o botão direito na pasta do projeto, abra o menu e execute o comando Git Log. Você verá todo o histórico de commits da branch atual do projeto.


4.2 Criando seu próprio projeto no MetaEditor

Um novo projeto pode ser criado diretamente no MetaEditor. Ele pode ser privado (1), criado em qualquer pasta do diretório MQL5, ou público (2), criado no diretório Shared Projects. As instruções completas para trabalhar com projetos estão disponíveis na ajuda online do editor, na página "Criando e trabalhando com um projeto".