gget

O que gget faz?

Use esta habilidade quando uma tarefa precisar de consulta bioinformática rápida em bancos de dados genômicos de referência com o CLI gget ou pacote Python.

Quando Usar

• Encontrar IDs Ensembl, metadados de genes, detalhes de transcritos ou sequências.
• Executar consultas BLAST ou BLAT rápidas sem construir um pipeline local completo.
• Obter links de genomas de referência e anotações do Ensembl.
• Consultar módulos de estrutura de proteínas, vias, câncer, expressão ou associação a doenças por meio de uma única interface.
• Criar um log de evidências reproduzível de primeira passagem antes de recorrer a ferramentas mais pesadas, como Biopython, Snakemake, Nextflow, BLAST+ ou clientes específicos de bancos de dados.

Use um workflow dedicado em vez de gget quando a tarefa exigir interpretação clínica regulamentada, pipelines de produção de alto rendimento ou controle rigoroso sobre versões de bancos de dados e índices locais.

Instalação

Use um ambiente Python limpo.

python -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install --upgrade gget
gget --help

Se uv estiver disponível:

uv venv
. .venv/bin/activate
uv pip install gget

Antes de confiar em um ambiente antigo, atualize o gget e verifique novamente a documentação dos módulos. Os bancos de dados upstream consultados pelo gget mudam com o tempo.

Padrões Básicos

Forma CLI:

gget <módulo> [argumentos] [opções]

Forma Python:

import gget

resultado = gget.search(["BRCA1"], species="human")
print(resultado)

Workflow comum:

1. Identifique a espécie, montagem, tipo de ID do gene e banco de dados necessários.
2. Verifique a documentação atual do módulo para obter os argumentos.
3. Execute uma consulta pequena primeiro.
4. Salve a saída com um nome de arquivo e data explícitos.
5. Registre o nome do módulo, versão, argumentos e premissas do banco de dados.

Módulos Comuns

Use a documentação upstream atual para argumentos exatos. Estes módulos são escolhas comuns iniciais:

• gget search: encontrar IDs Ensembl a partir de termos de busca.
• gget info: recuperar metadados para Ensembl, UniProt ou IDs relacionados.
• gget seq: obter sequências de nucleotídeos ou aminoácidos.
• gget ref: recuperar links de download de genomas de referência.
• gget blast: executar uma consulta BLAST rápida.
• gget blat: localizar uma sequência contra montagens genômicas suportadas.
• gget muscle: executar alinhamento múltiplo de sequências.
• gget diamond: executar alinhamento local de sequências contra sequências de referência.
• gget alphafold e gget pdb: inspecionar referências de estruturas de proteínas.
• gget enrichr, gget opentargets, gget archs4, gget bgee, gget cbio e gget cosmic: explorar dados de enriquecimento, alvos, expressão, câncer e associação a doenças.

Não presuma que todo módulo suporta todas as versões de Python ou conjuntos de dependências. Algumas dependências científicas opcionais têm suporte de versão mais restrito do que o pacote principal.

Exemplos Rápidos

Encontrar genes:

gget search -s human brca1 dna repair -o brca1-search.json

Obter metadados de genes:

gget info ENSG00000012048 -o brca1-info.json

Obter uma sequência:

gget seq ENSG00000012048 -o brca1-seq.fa

Executar uma consulta BLAST pequena:

gget blast "MEEPQSDPSVEPPLSQETFSDLWKLLPEN" -l 10 -o blast-results.json

Exemplo Python:

import gget

genes = gget.search(["BRCA1", "DNA repair"], species="human")
info = gget.info(["ENSG00000012048"])
sequencia = gget.seq("ENSG00000012048")

Log de Reprodutibilidade

Para saídas científicas, inclua metadados suficientes para reproduzir a consulta.

| Data | Versão do gget | Módulo | Consulta | Espécie/montagem | Saída | Notas |
| --- | --- | --- | --- | --- | --- | --- |
| 2026-05-11 | `gget --version` | search | `BRCA1 DNA repair` | human | `brca1-search.json` | Documentação verificada antes da execução |

Registre também:

• A versão do Python e o gerenciador de ambiente.
• Qualquer dependência opcional instalada por meio de gget setup.
• Identificadores específicos do banco de dados retornados pela consulta.
• Se a saída é JSON, CSV, FASTA ou uma exportação de DataFrame.
• Quaisquer falhas que foram resolvidas atualizando o gget.

Lista de Verificação de Revisão

• Você atualizou ou verificou a versão instalada do gget?
• Você verificou a documentação atual do módulo upstream antes de usar os argumentos?
• A espécie ou montagem está explícita?
• Os identificadores são preservados exatamente, incluindo prefixos Ensembl/UniProt?
• O resultado está rotulado como saída de banco de dados, e não como interpretação clínica?
• A consulta é reproduzível a partir do comando salvo ou do trecho Python?
• As dependências opcionais estão instaladas em um ambiente isolado?

Referências

• Documentação do gget
• Atualizações do gget
• Repositório GitHub do gget
• Artigo de Bioinformática do gget