gget

O que gget faz?

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

Quando Usar

• Encontrar IDs Ensembl, metadados de genes, detalhes de transcritos ou sequências.
• Executar consultas BLAST ou BLAT rápidas sem montar 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 através de uma única interface.
• Criar um log de evidências inicial e reprodutível antes de migrar para 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 regulada, pipelines de produção de alto rendimento ou controle fino 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 do módulo. Os bancos de dados upstream consultados pelo gget mudam com o tempo.

Padrões Básicos

Forma da 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 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 suposições 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 dependências definidas. Algumas dependências científicas opcionais têm suporte de versão mais restrito 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"])
sequence = gget.seq("ENSG00000012048")

Log de Reprodutibilidade

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

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

Registre também:

• Versão do Python e gerenciador de ambiente.
• Qualquer dependência opcional instalada via 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.
• Qualquer falha resolvida pela atualização do gget.

Lista de Verificação

• Você atualizou ou verificou a versão instalada do gget?
• Você consultou 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 os 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 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 do gget na Bioinformatics