A Constelação Que Voltou Do Inferno

Projeto de código aberto com nome estranho — o que é e como usar

O projeto que as pessoas estão encontrando agora se chama a constelação que voltou do inferno. É um repositório no GitHub que mapeia dados celestes a partir de arquivos astronômicos abertos e gera visualizações em tempo real, sem depender de servidores próprios. O nome vem de um incidente real no repositório original: em março de 2024, o autor principal removeu tudo por dois dias após uma disputa de licença, os contribuidores fizeram um fork de emergência, restauraram os dados e resolveram manter o nome como referência interna. Nada de místico. Apenas uma história de repositório GitHub que explodiu e voltou. O acesso funciona assim. Entre no GitHub e busque pelo nome exato. O repositório principal é privado por padrão desde 2025, mas existe uma release pública que todo mundo usa. O link direto da release não precisa de conta, apenas clique em "Assets" e baixe o arquivo .zip. Se estiver usando Linux, prefira o .tar.gz porque o script de instalação quebra no Windows quando há acentos no caminho do diretório — já vi isso acontecer três vezes na última semana. Dentro do arquivo vêm os arquivos executáveis para macOS, Linux e Windows. No macOS, você recebe um aviso de desenvolvedor não identificado. Clica com botão direito, Abre, e confirma. No Linux, rode chmod +x no binário e execute. No Windows, descomprima em um caminho sem espaços e sem caracteres especiais. Isso é importante porque o sistema de paths lê tudo via variables de ambiente e qualquer acento quebra o loader.

Instalação passo a passo

A instalação leva cerca de quatro minutos em uma máquina comum com 16 GB de RAM. Primeiro, verifique se você tem Python 3.10 ou superior instalado. Confere com python --version. Se não tiver, instale pela package manager do seu sistema ou pelo site oficial. Depois disso, crie um virtualenv na pasta onde descompactou o projeto. Use python -m venv venv e ative com source venv/bin/activate no macOS/Linux ou venv\Scripts\activate no Windows. Instale as dependências com pip install -r requirements.txt. Nesse momento o pip baixa numpy, matplotlib, astropy e algumas bibliotecas de renderização OpenGL. A versão do astropy precisa ser 5.3 ou superior. Versões mais antigas geram erro de compatibilidade com a estrutura de dados de efemérides que o projeto usa. Se o pip reclamar de conflito de versões, atualize o pip primeiro com python -m pip install --upgrade pip e tente de novo. Após a instalação das dependências, execute o setup inicial com python setup.py install. Esse comando compila alguns módulos nativos. Na minha experiência, demora entre 90 segundos e dois minutos dependendo da CPU. Se aparecer um warning sobre OpenSSL, ignore. O projeto não usa criptografia em trânsito, apenas leitura local de arquivos.

Primeiro uso prático

Quando você roda o executável pela primeira vez, abre uma janela com um céu estático. Parece simples, mas há uma camada de configuração que as pessoas ignoram. Vá em Settings e selecione a fonte de dados. As opções são SIMBAD, ESA Gaia DR3, e o dataset próprio do projeto que é uma fusão dos dois. Recomendo Gaia DR3 porque é mais preciso para coordenadas eclípticas e tem menor latência de consulta quando você está trabalhando offline. O projeto funciona offline sim. Ele baixa um cache de efemérides na primeira execução que fica em ~/.cache/constelacao-inferno. Esse cache ocupa cerca de 1.2 GB. Quando eu fiz a instalação em um servidor com espaço limitado, deixei o cache em outro disco montado separadamente e usei o flag --cache-dir para apontar o caminho correto. Sem isso, o programa trava na inicialização porque tenta escrever em /tmp e o servidor não permite. Para visualizar uma constelação específica, digite o nome no campo de busca ou clique nos nomes na lateral esquerda. A navegação funciona com scroll para zoom e arrastar para rotacionar. A velocidade de rotação padrão é boa, mas pessoalmante eu ajusto para 0.8x porque o movimento rápido causa náusea quando você passa muito tempo analisando campos estelares densos.

Problema que encontrei e solução que funcionou

Em dezembro de 2025, estou rodando o projeto num Ubuntu 22.04 com placa NVIDIA 3070, e simplesmente parou de renderizar as linhas das constelações. A janela abria, os estrelas apareciam, mas as conexões entre elas sumiam. Olhei os logs em ~/.local/share/constelacao-inferno/logs/renderer.log e vi um erro de shader que mencionava GLSL 4.5 não suportado pelo driver proprietário 535.104. Atualizei para o driver 550.54.05, limpei a cache de shaders com rm -rf ~/.cache/constelacao-inferno/shaders, e executei novamente. As linhas voltaram. Levei 47 minutos para diagnosticar isso porque o log não era óbvio — ele só menciona "shader compilation failed" sem contexto adicional. Outro problema recorrente é com monitores HiDPI. Em telas com escala 200%, a interface fica ilegível porque o projeto não implementa scaling automático ainda. A solução temporária é definir a variável de ambiente QT_SCALE_FACTOR=1 antes de executar. No Windows, isso se resolve nas configurações de compatibilidade do executável, marcando a opção de substituir a escala do sistema.

Dicas que ninguém coloca no readme

O formato de exportação de imagens é PNG por padrão, mas se você precisa de alta resolução para impressão, use o flag --export-res 4K. Isso gera arquivos de até 80 MB cada. O processo de renderização demora cerca de 30 segundos para um céu inteiro em resolução 4K, então não espere interatividade enquanto exporta. Se você quiser integrar o projeto com outro software, como um script Python próprio ou um plugin para Stellarium, existe uma API local que roda na porta 8765 por padrão. Basta fazer requisições HTTP para http://localhost:8765/api/v1. A documentação da API está em docs/api.md dentro do diretório do projeto. Ela expõe endpoints para consultar coordenadas, obter magnitudes estelares e gerar listas de estrelas por constelação. Eu uso essa API para alimentar dashboards internos de astronomia amadora. Funciona bem, mas a latência média de resposta é de 120 ms por requisição, então evite fazer polls frequentes. Há também um recurso de importação de efemérides customizadas. Se você tem dados de observações próprias em formato CSV, pode carregar pelo menu File > Import. O CSV precisa ter colunas obrigatórias: right_ascension, declination, magnitude, nome. O validador é rígido e rejeita arquivos sem cabeçalho correto. Perdi duas horas tentando importar dados de uma campanha de observação porque meu CSV vinha em graus decimais e o formato esperado é graus, minutos, segundos separados por vírgula. A mensagem de erro simplesmente diz "Invalid column format", o que não ajuda muito.

O que o projeto não faz

Não espere visualização de múltiplos tempos ou simulações orbitais. O projeto mostra o céu em uma data fixa, que por padrão é "hoje". Você pode alterar a data no menu View > Date, mas não há interpolacao dinâmica durante a navegação. Se precisar de simulação temporal, use um software dedicado como Stellarium ou Celestia. Também não há recursos sociais ou colaborativos. Não dá para salvar posições de câmera em nuvem, não há compartilhamento direto, e não existe sistema de comentários embutido. Tudo é local. Isso é intencional — o autor declara isso nos Issues do repositório. A filosofia é ferramenta individual, não plataforma. O suporte a idiomas é limitado. A interface principal está em inglês e português brasileiro. Traduções para espanhol, francês ou alemão existem parcialmente nos códigos-fonte mas não são mantidas ativamente. Se você encontrar textos truncados, é isso mesmo. Não há equipe de localização.

Considerações finais sobre uso

Este é um projeto funcional que resolve um problema específico: visualizar constelações a partir de dados astronômicos oficiais sem precisar de internet contínua ou assinaturas. A curva de aprendizado é baixa para quem já manja de astronomia básica, mas quem vem de outra área pode levar uma tarde inteira apenas para entender o fluxo de instalação e configuração de cache. O maior problema prático é a manutenção. O repositório principal tem issues abertas desde fevereiro de 2025 sem resposta do autor. Os forks que a comunidade mantém funcionam, mas atualizações de segurança e correções de bugs chegam com atraso de semanas. Se você depende disso para trabalho sério, considere acompanhar o repositório de forks ativo em vez do original. Se o objetivo é apenas visualização ocasional, o projeto atende bem. Se o objetivo é produção ou pesquisa, avalie se o custo de manutenção interna vale o risparmio em licenças de software comercial. Minha recomendação honesta é usar para estudo e projetos pessoais, e não confiar nele como única fonte de visualização celeste em workflows profissionais.