Evidências focadas em engenharia reversa de malware com inspeção profunda de PE/.NET, reconstrução com Ghidra, verificações cruzadas com IA, YARA e depuração de ELF
CLI de engenharia reversa com foco em evidências. Andrey Pautov desenvolve a interface de análise em Python, triagem offline, inteligência de strings, inspeção de PE e fluxos de relatórios. Capstone, Ghidra, GDB e provedores de IA opcionais são integrações, não ferramentas originais criadas por este projeto.
Relevância do papel: Triagem de malware, ferramentas de engenharia reversa, análise assistida por IA segura, entrega em Python.
Execute a demonstração local segura e revise o escopo de validação · Validação local registrada
AIDebug é uma CLI e interface de terminal de engenharia reversa de malware com foco em evidências. Ela combina triagem offline determinística, inspeção hexadecimal do arquivo completo, análise profunda da estrutura PE, desmontagem com Capstone, reconstrução com Ghidra, verificações cruzadas opcionais com LLM, depuração local de ELF, exercícios de aprendizado compilados e relatórios para revisão do analista.
Versão atual do código-fonte: AIDebug 3.1.0. Consulte as notas de versão 3.1.0.
A versão publicada imutável mais recente continua sendo AIDebug v3.0.0, disponível como
1200km-aidebug, até que a tag 3.1.0 correspondente à versão e a release no GitHub concluam o fluxo de publicação verificado.
Instale o pacote estável do PyPI nestas três etapas:
python3 -m venv .venv
source .venv/bin/activate
Execute o bootstrap seguro do pip com reconhecimento de versão nesse ambiente. Ele preserva versões mais recentes do pip e verifica o hash do wheel fixado quando uma atualização é necessária. Pare se falhar; não continue para a instalação do pacote.
Instale o pacote estável:
python -m pip install 1200km-aidebug==3.0.0
aidebug --version
Instale recursos opcionais conforme necessário:
# LLM provider clients and local validation of AI-generated YARA candidates
python -m pip install "1200km-aidebug[ai]==3.0.0" "certifi>=2026.10.19"
# Frida dynamic instrumentation
python -m pip install "1200km-aidebug[dynamic]==3.0.0"
# All optional Python integrations
python -m pip install "1200km-aidebug[all]==3.0.0" "certifi>=2026.10.19"
O String Intelligence requer o código-fonte 3.1 até que seu pacote seja publicado. A
revisão da 3.1
fixa a revisão abaixo. Seu código de execução também corresponde à revisão principal auditada de 1º de outubro
80b0b7172b592814504c405a16bf4cc0ce4161eb.
git clone https://github.com/anpa1200/AIDebug.git
cd AIDebug
git checkout cd81ef242db0bcea3296970d45c241a4228d2d27
python3 -m venv .venv
source .venv/bin/activate
Antes de instalar as dependências, execute o bootstrap seguro do pip com reconhecimento de versão neste ambiente. O checkout histórico não inclui o auxiliar de bootstrap atual. Pare se o bootstrap falhar. Continue apenas depois que ele for bem-sucedido:
python -m pip install -e .
aidebug --version
A partir desse checkout, adicione extras com python -m pip install -e ".[ai]" "certifi>=2026.10.19",
".[dynamic]", ou ".[all]" "certifi>=2026.10.19". Mantenha os extras na mesma trilha de instalação:
instalar "1200km-aidebug[ai]==3.0.0" sobre o código-fonte 3.1 pode substituí-lo pelo
pacote 3.0 publicado.
Para um checkout de desenvolvimento em movimento:
git clone https://github.com/anpa1200/AIDebug.git
cd AIDebug
python3 -m venv .venv
source .venv/bin/activate
python scripts/bootstrap_pip.py
python -m pip install -e ".[dev,dynamic]"
Ghidra, GDB, Bubblewrap, um compilador C e componentes de destino do Frida são ferramentas externas usadas apenas pelos fluxos de trabalho que as exigem.
O AIDebug foi aceito no REMnux em 7 de outubro de 2026 por meio do
PR #355, incluído pela primeira vez no
salt-states v2026.41.4.
O estado aceito
instala o 1200km-aidebug[ai] sem fixação de versão a partir do PyPI em /opt/aidebug, habilita
atualizações e expõe /usr/local/bin/aidebug. Conforme verificado em 8 de outubro de 2026,
o PyPI ainda fornece a versão 3.0.0; isso não instala o código-fonte 3.1 não publicado nem o
extra dynamic. Use --offline para manter a análise local.
Consulte Configuração do REMnux e limites de versão.
Abra uma amostra PE ou ELF na interface principal do terminal:
aidebug --binary /path/to/sample.exe --offline
Execute a análise determinística sem a interface de tela cheia e exporte as evidências:
aidebug --binary /path/to/sample.exe \
--offline --no-tui --report --json-export --yara \
--out-dir reports/
Use a reconstrução do Ghidra:
aidebug --binary /path/to/sample.exe --offline --no-tui --decompile
aidebug --binary /path/to/sample.exe --offline --no-tui \
--decompile-all reports/sample-reconstruction.c
Analise uma unidade de tradução C por meio de um artefato ELF temporário e não executado: