OGhidra — OGhidra relie les grands modèles de langage (LLM) via Ollama à la plateforme de rétro-ingénierie Ghidra, permettant une analyse binaire pilotée par l'IA grâce au langage naturel. Interagissez avec Ghidra à l'aide de requêtes conversationnelles et automatisez des flux de travail complexes de rétro-ingénierie. | Kitploit

graph TD
    A[User Query] --> B[Planning Phase]
    B --> C{Execution Phase}
    C -- Tool Calls --> D[Ghidra/LLM]
    D --> C
    C --> E[Review Phase]
    E -- Agentic Loop --> B
    E --> F[Final Response]

    style E fill:#f9f,stroke:#333,stroke-width:2px
    style B fill:#bbf,stroke:#333,stroke-width:2px

# Clone repository
git clone https://github.com/LLNL/OGhidra.git
cd OGhidra

# Install dependencies (choose one)
uv sync                          # Using UV (recommended)
pip install -r requirements.txt  # Using pip

# Configure environment
cp .env.example .env
# Edit .env with your settings

Prérequis :
- Ghidra 12.0.3 installé
- Java 21

Option 1 : Utilisation des scripts de compilation automatisés :

Windows :

# Set the path to your Ghidra installation (will attempt to find last run copy of Ghidra if not set)
set GHIDRA_INSTALL_DIR=C:\path\to\ghidra_12.0.3_PUBLIC

# Run the build script
build_ghidra_plugin.bat

Unix/Linux/Mac :

# Set the path to your Ghidra installation (will attempt to find the last run copy of Ghidra if not set)
export GHIDRA_INSTALL_DIR=/path/to/ghidra_12.0.3_PUBLIC

# Run the build script (make it executable first if needed)
chmod +x build_ghidra_plugin.sh
./build_ghidra_plugin.sh

Option 2 : Compilation manuelle :

Créez/mettez à jour OGhidraMCP/gradle.properties avec votre chemin d'installation de Ghidra :
```
GHIDRA_INSTALL_DIR=/absolute/path/to/ghidra_12.0.3_PUBLIC
```

Sur Unix/Linux/macOS :

cd OGhidraMCP
$GHIDRA_INSTALL_DIR/support/gradle/gradlew buildExtension --info

Sur Windows :

cd OGhidraMCP
"%GHIDRA_INSTALL_DIR%\support\gradle\gradlew.bat" buildExtension --info

Localisez l'extension compilée :
- Le fichier zip de l'extension est créé dans OGhidraMCP/dist/
- Le nom du fichier ressemblera à ghidra_12.0.3_PUBLIC_YYYYMMDD_OGhidraMCP.zip

# For Ollama (local models)
ollama pull gemma3:27b           		# Good balance (20GB RAM)
ollama pull nomic-embed-text     		# Embedding model for RAG

# Alternative models
ollama pull gpt-oss:120b         		# High quality (80GB RAM)
ollama pull devstral-2:123b 			# High quality (80GB RAM)
ollama pull devstral-2:123b-cloud       # Cloud Model

LLM_PROVIDER=custom_api
CUSTOM_API_URL=https://api.example.com/v1/chat/completions
CUSTOM_API_KEY=your-api-key-here
CUSTOM_API_MODEL=your-model-name
CUSTOM_API_EMBEDDING_MODEL=your-embedding-model

# Context budget in tokens (adjust to your model's limit)
CONTEXT_BUDGET=100000              # 100K tokens for mid-size models
                                   # 200K+ for frontier models

# Execution settings
MAX_EXECUTION_STEPS=5              # Steps per planning cycle
MAX_AGENTIC_CYCLES=3               # How many plan-execute-review loops
AGENTIC_LOOP_ENABLED=true          # Enable adaptive replanning

Tool	Description
Analyze Current Function	Analyse approfondie du comportement de la fonction sélectionnée
Rename Current Function	L'IA suggère des noms pertinents en fonction de l'analyse
Rename All Functions	Renommage en masse avec les options Smart/Full/Rename-Only
Analyze Imports	Identifie les bibliothèques et les dépendances externes
Analyze Strings	Trouve les URL, identifiants et données de configuration
Generate Report	Évaluation complète de la sécurité

# In GUI: Use "Task Mode" dropdown
# In CLI: set task_mode <mode>

task_mode malware      # Malware analysis with pattern detection
task_mode vuln         # Vulnerability research focus
task_mode general      # General reverse engineering

# Enumerate all functions with AI summaries
# Choose from:
- Rename Only: Only process generic function names
- Smart Enumeration: Focus on security-relevant functions
- Full Enumeration: Analyze every function in the binary

# Save progress
File → Save Session

# Load previous work
File → Load Session

# Auto-save after bulk operations
# Sessions include:
- Analyzed functions with summaries
- RAG vectors for semantic search
- Performance statistics
- UI state

# In GUI: Click "Generate Report" button
# Report includes:
- Executive Summary
- Function Inventory (renamed functions with behavior)
- Security Analysis (high-risk functions, patterns)
- Import Analysis
- String Analysis
- Recommendations

┌─────────────────────────────────────────────────────────────┐
│                        OGhidra UI                           │
│                  (GUI / Interactive CLI)                    │
└────────────────────────┬────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────┐
│                   Bridge (src/bridge.py)                    │
│  ┌────────────────────────────────────────────────────────┐ │
│  │ • Agentic Loop: Plan → Execute → Review → Replan       │ │
│  │ • Tool Router: Ghidra client, LLM client, CAG manager  │ │
│  │ • Context Manager: Budget allocation, compression      │ │
│  └────────────────────────────────────────────────────────┘ │
└───────────┬────────────────────────┬────────────────────────┘
            │                        │
            ▼                        ▼
┌───────────────────────┐  ┌─────────────────────────┐
│   Ghidra Client       │  │   LLM Clients           │
│ • GhidraMCP Plugin    │  │ • Ollama (local)        │
│ • Binary operations   │  │ • External APIs         │
│ • Decompilation       │  │ • Custom endpoints      │
└───────────────────────┘  └─────────────────────────┘
            │                        │
            └────────────┬───────────┘
                         ▼
┌─────────────────────────────────────────────────────────────┐
│               CAG Manager (Knowledge System)                │
│  ┌────────────────────────────────────────────────────────┐ │
│  │ • Vector Store: Semantic search over functions         │ │
│  │ • Pattern Detector: 12+ malware techniques             │ │
│  │ • Metadata Extractor: Structured function analysis     │ │
│  │ • Session Store: Persistent analysis state             │ │
│  └────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

Backend Option	Description
`http`	Utilise le backend GhidraMCP
`pyghidra`	Utilise le backend PyGhidra

OGhidra

Populaires

À propos

OGhidra 3 - Rétro-ingénierie assistée par l'IA avec Ghidra

Qu'est-ce qu'OGhidra ?

Comment ça fonctionne

Démarrage rapide

Prérequis

Installation

Configuration du plugin Ghidra

Compilation de l'extension GhidraMCP

Installation de l'extension GhidraMCP

Télécharger les modèles IA

Lancer OGhidra

Configuration

Option 1 : Modèles locaux (Ollama)

Option 2 : API externes

Option 3 : API personnalisée compatible OpenAI

Paramètres de gestion du contexte

Fonctionnalités clés

1. Boutons d'outils intelligents (GUI)

2. Modes de tâche

3. Détection de motifs de malwares

4. Énumération intelligente

5. Gestion des sessions

Configuration du backend

Sélection d'un backend

Configuration PyGhidra

Utilisation d'un projet Ghidra existant

Sélection d'un programme

Lancement direct d'un binaire

Flux de travail courants

Analyser un binaire suspect

Générer un rapport de sécurité

Examiner une fonction spécifique

Fonctionnalités avancées

RAG (génération augmentée par récupération)

Optimisation du contexte

Journalisation LLM

Dépannage

Problèmes de connexion à Ghidra

Problèmes de connexion à Ollama

Réponses vides / Dépassement de contexte

Performances lentes

Vue d'ensemble de l'architecture

Contribuer

Citation

Remerciements

Licence

Support