
証拠重視のマルウェアリバースエンジニアリング。PE/.NETの詳細な検査、Ghidraによる再構築、AIによるクロスチェック、YARA、ELFデバッグに対応。
エビデンス重視のリバースエンジニアリングCLI。 Andrey PautovがPythonアナリストインターフェース、オフライントリアージ、文字列インテリジェンス、PE検査、レポーティングワークフローを開発しています。Capstone、Ghidra、GDB、およびオプションのAIプロバイダーは統合機能であり、本プロジェクトが独自に作成したツールではありません。
役割との関連性: マルウェアトリアージ、リバースエンジニアリングツール、安全なAI支援分析、Pythonによる提供。
安全なローカルデモを実行し、検証スコープを確認する · 記録済みのローカル検証
AIDebugはエビデンス重視のマルウェアリバースエンジニアリングCLIおよびターミナルUIです。 決定論的なオフライントリアージ、ファイル全体の16進検査、詳細なPE 構造解析、Capstone逆アセンブリ、Ghidra再構築、オプションのLLM クロスチェック、ローカルELFデバッグ、コンパイル済み学習演習、および アナリストレビュー用レポーティングを組み合わせています。
現在のソースバージョン: AIDebug 3.1.0。詳細は 3.1.0リリースノートを参照してください。
最新の不変公開リリースは引き続き AIDebug v3.0.0であり、
1200km-aidebugとして提供されています。 バージョン一致の3.1.0タグとGitHubリリースが検証済みの 公開ワークフローを完了するまでの間、こちらが最新となります。
PyPIから安定版パッケージを次の3ステップでインストールします:
python3 -m venv .venv
source .venv/bin/activate
その環境でバージョン対応のセキュアな pip ブートストラップを実行します。これは新しい pip バージョンを保持し、アップグレードが必要な場合は固定された wheel のハッシュを検証します。失敗した場合は停止し、パッケージのインストールに進まないでください。
安定版パッケージをインストールします:
python -m pip install 1200km-aidebug==3.0.0
aidebug --version
必要に応じてオプション機能をインストールします:
# 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"
String Intelligence はパッケージが公開されるまでソース 3.1 を必要とします。
3.1 レビュー
では以下のリビジョンを固定しています。そのランタイムコードは、監査済みの 10 月 1 日
main リビジョン 80b0b7172b592814504c405a16bf4cc0ce4161eb とも一致します。
git clone https://github.com/anpa1200/AIDebug.git
cd AIDebug
git checkout cd81ef242db0bcea3296970d45c241a4228d2d27
python3 -m venv .venv
source .venv/bin/activate
依存関係をインストールする前に、この環境で バージョン対応のセキュアな pip ブートストラップ を実行してください。過去のチェックアウトには現在の ブートストラップヘルパーが含まれていません。ブートストラップが失敗した場合は停止してください。成功した後にのみ続行してください:
python -m pip install -e .
aidebug --version
そのチェックアウトから、python -m pip install -e ".[ai]" "certifi>=2026.10.19"、".[dynamic]"、または ".[all]" "certifi>=2026.10.19" で extras を追加します。extras は同じインストールトラックに保ってください:ソース 3.1 の上に "1200km-aidebug[ai]==3.0.0" をインストールすると、公開されている 3.0 パッケージに置き換わる可能性があります。
移動する開発チェックアウトの場合:
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、C コンパイラ、および Frida のターゲットコンポーネントは、それらを必要とするワークフローでのみ使用される外部ツールです。
AIDebug は 2026年10月7日 に
PR #355 を通じて REMnux に採用され、
salt-states v2026.41.4 で初めて含まれました。
採用された state
は、バージョン固定されていない 1200km-aidebug[ai] を PyPI から /opt/aidebug にインストールし、
アップグレードを有効化し、/usr/local/bin/aidebug を公開します。2026年10月8日に確認されたとおり、
PyPI は依然として 3.0.0 を提供しており、これは未公開の 3.1 ソースや
dynamic extra をインストールするものではありません。分析をローカルに保つには --offline を使用してください。
REMnux のセットアップとバージョンの境界を参照してください。
メインのターミナルインターフェースで PE または ELF サンプルを開きます:
aidebug --binary /path/to/sample.exe --offline
フルスクリーンUIを使わずに決定論的分析を実行し、証拠をエクスポートします:
aidebug --binary /path/to/sample.exe \
--offline --no-tui --report --json-export --yara \
--out-dir reports/
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
一時的な非実行ELFアーティファクトを通じて、1つのC翻訳単位を解析します:
aidebug --source /path/to/example.c --offline --no-tui
ファイル名の拡張子に依存せずに任意のファイルを識別します:
aidebug --identify /path/to/renamed-or-unknown-file --offline
--identify は、宣言された型、MIME タイプ、一般的な拡張子、信頼度、判定方法、根拠、SHA-256、およびサイズを含む構造化 JSON を報告します。決定論的なカバレッジには、一般的な実行ファイルおよびバイトコード形式、アーカイブおよびディスクイメージ、Office/OpenDocument/EPUB コンテナ、ドキュメント、画像、音声/動画、パケットキャプチャ、データベース、レジストリ/イベントログのアーティファクト、スクリプト、およびテキストが含まれます。ZIP の分類では最初の 4,096 個の名前を考慮し、mimetype エントリの最大 128 バイトを読み取ります。Python は名前の制限が適用される前にセントラルディレクトリを解析します。これは初期のディレクトリ解析メモリを制限するものではありません。入力全体は 128 MiB に制限され、ファイルが実行または展開されることはありません。組み込みのキャプチャシグネチャは、両方のバイトオーダーにおけるナノ秒 PCAP および PCAP-NG をカバーします。従来のマイクロ秒 PCAP シグネチャは現在欠落しています。オプションの libmagic がそれらを認識できる場合があります。
ローカルプラットフォームで認識される追加のシグネチャのために、python-magic とオペレーティングシステムの libmagic データベースをインストールしてください:
python -m pip install python-magic
決定論的なシグネチャ、構造、テキストルールのいずれにも一致しない場合、設定されたAIプロバイダーが限定的なメタデータから候補を推測することがあります。そのメタデータとは、拡張子、サイズ、SHA-256、最大96バイトのヘッダー、32バイトの末尾、サンプルのエントロピー、NUL比率です。ファイル本体、抽出された文字列、ファイルシステムパスは送信されません。AIのみの結果はai-inferenceとラベル付けされ、信頼度は最大60%に制限され、アナリストによる検証が必要です。フォールバックを完全に無効にするには--offlineを使用してください。解決できない型はUnknownとして報告され、終了ステータスは2になります。
メインのターミナルインターフェースでSを押すか、ワークスペース内で直接起動します:
aidebug --binary /path/to/sample.exe --offline --strings
ワークスペースは、ファイルオフセット、利用可能な場合はマップ済みアドレス、エンコーディング、バイト長と文字長、重複出現情報、セクションコンテキスト、信頼度、トリアージスコア、および各分類の決定論的な理由を保持します。フィルタは最小長、エンコーディング、カテゴリ、フリーテキスト検索をカバーし、列ソートとページネーションにより大規模なインベントリでも扱いやすく保ちます。選択された各エンコーディングは、サイズ上限付きの成果物全体をスキャンします。保持されるインベントリは25,000レコード、値ごとに表示4,096文字に制限され、正確な候補数/省略数と全バイトカバレッジにより、どちらの上限も可視化されます。各レコードは最大32件のDLL/APIアノテーションと4,096文字の説明を保持し、敵対的なオーバーフローはレコードの理由に報告されます。