KRAKEN

किसी प्रोग्राम को अलग-अलग हिस्सों में समझें और उसे समझें, एक मददगार हाथ के साथ। KRAKEN एक ओपन-सोर्स रिवर्स-इंजीनियरिंग वर्कबेंच है जो Ghidra के डीकंपाइलर पर बना है, जिसमें Java-रहित नेटिव इंजन और एक वैकल्पिक पूर्ण Ghidra इंजन है। आप, आपकी स्क्रिप्ट्स और AI एजेंट्स सभी एक ही कमांड के सेट के माध्यम से एक ही प्रोजेक्ट पर काम करते हैं, और हर संपादन लॉग किया जाता है, उसका श्रेय दिया जाता है और उसे पूर्ववत किया जा सकता है। शुरू करने के लिए आपको रिवर्स इंजीनियरिंग जानने की आवश्यकता नहीं है: ऐप चलते-चलते शब्दों को समझाता है और ट्यूटोरियल आपको पहले सत्र में मार्गदर्शन करता है। दीर्घकालिक लक्ष्य बाइनरीज़ को Rust में फिर से लिखना है, फ़ंक्शन दर फ़ंक्शन, मूल के विरुद्ध जाँच करते हुए।

एक वास्तविक नेटिव-इंजन प्रोजेक्ट: इस रिपॉज़िटरी से stripped_calc-O2-stripped, कुछ फ़ंक्शन्स के नाम रखे जाने के बाद।

यह क्या करता है

विश्लेषण करें

• Ghidra के डीकंपाइलर के साथ फ़ंक्शन्स ढूँढता है और उन्हें C-जैसे कोड में डीकंपाइल करता है: नेटिव इंजन के माध्यम से (Java नहीं; ELF और Windows PE, x86 और x86-64) या वैकल्पिक Ghidra इंजन के माध्यम से (ELF, PE और Mach-O, कई प्रोसेसर)।
• लिस्टिंग, हेक्स, कंट्रोल-फ़्लो ग्राफ़, क्रॉस-रेफ़रेंस, स्ट्रिंग्स, इम्पोर्ट्स और एक्सपोर्ट्स, मेमोरी मैप।
• फ़ंक्शन्स का नाम बदलें, टाइप और टिप्पणियाँ सेट करें। व्यूज़ के बीच खोजें, फ़िल्टर करें और जंप करें।

पैच करें

• किसी प्रोग्राम के बाइट्स बदलें: एक नया निर्देश टाइप करें और KRAKEN उसे असेंबल करता है, या डीकंपाइल किए गए C को संपादित करें और सहायक को सबसे छोटा मशीन-कोड परिवर्तन निकालने दें।
• कुछ भी लिखे जाने से पहले मूल और पैच किए गए प्रोग्राम को एक सैंडबॉक्स्ड एमुलेटर में साथ-साथ चलाएँ, फिर पैच किया गया कॉपी एक्सपोर्ट करें। मूल फ़ाइल को कभी छुआ नहीं जाता।
• हर पैच इतिहास में एक संपादन है, इसलिए सहायक के पैच को बाकी सब चीज़ों की तरह समीक्षा और पूर्ववत किया जा सकता है।

AI

• अंतर्निहित सहायक: किसी फ़ंक्शन को समझाएँ, किसी प्रोग्राम पर एक निर्देशित पहली नज़र, नाम सुझाव जिन्हें आप कुछ भी बदलने से पहले समीक्षा करते हैं, और एक ऑफ़लाइन शब्दावली।
• आपके कंप्यूटर पर एक मॉडल के साथ काम करता है (Ollama, LM Studio, llama.cpp, या एक जो KRAKEN आपके लिए चलाता है) या किसी क्लाउड प्रदाता के साथ।
• टर्मिनल एजेंट्स (Claude Code, Codex, Gemini CLI) ऐप के अंदर चल सकते हैं या MCP के माध्यम से बाहर से कनेक्ट कर सकते हैं।

स्वचालित करें

• एक कमांड रजिस्ट्री CLI, MCP सर्वर, GUI और एजेंट्स को चलाती है, इसलिए वे एक-दूसरे से अलग नहीं हो सकते।
• स्क्रिप्ट्स के लिए --json आउटपुट, एक Python मॉड्यूल, और एक बैकग्राउंड डेमॉन जो प्रोजेक्ट्स को तैयार रखता है।
• हर संपादन अपने लेखक के साथ एक लॉग में है, प्रति-परिवर्तन और प्रति-एजेंट-रन पूर्ववत करने की सुविधा के साथ।

फिर से लिखें

• एक बार में एक फ़ंक्शन को Rust में अनुवाद करें, मूल को एमुलेशन के अंतर्गत और Rust पक्ष को साथ-साथ चलाएँ, और वह सबसे छोटा इनपुट देखें जहाँ वे असहमत होते हैं।
• क्रम की योजना बनाएँ (पहले कैलीज़), सत्यापित फ़ंक्शन्स को स्वयं स्वीकार करें, एक Cargo वर्कस्पेस एक्सपोर्ट करें।

स्थिति

KRAKEN प्री-अल्फा (0.1a) है। अपरिष्कृत किनारों और ब्रेकिंग परिवर्तनों की अपेक्षा करें।

	Linux x86_64	macOS (Apple silicon)	Windows x86_64
CLI, MCP सर्वर, GUI	काम करता है	बिल्ड होता है, प्रयोगात्मक	बिल्ड होता है, प्रयोगात्मक
नेटिव इंजन, Java नहीं (kraken setup --native)	काम करता है (ELF और PE)	अभी नहीं	अभी नहीं
Ghidra के साथ विश्लेषण (kraken setup)	काम करता है	अभी नहीं	अभी नहीं
Ghidra के चारों ओर सैंडबॉक्स	Landlock	अभी नहीं	अभी नहीं
स्थानीय मॉडल	काम करता है	बिल्ड होता है	बिल्ड होता है
रीराइट पाइपलाइन	काम करता है (Landlock और एक मॉडल की आवश्यकता है)	चलने से इंकार करता है	चलने से इंकार करता है

"बिल्ड होता है" का अर्थ है कि कोड कंपाइल होता है और CI में जाँचा जाता है, यह नहीं कि पूरा उत्पाद वहाँ सिद्ध हो चुका है। Linux आज उपयोग करने के लिए प्लेटफ़ॉर्म है।

इंस्टॉल करें

Linux x86_64 (Java की आवश्यकता नहीं: नेटिव इंजन और उसकी प्रोसेसर फ़ाइलें रिलीज़ में हैं):

curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/Adam-AtlasSoftware/kraken/main/scripts/install.sh | bash

स्क्रिप्ट डाउनलोड को रिलीज़ के SHA256SUMS के विरुद्ध जाँचती है, sudo की आवश्यकता नहीं होती और यह ~/.local में इंस्टॉल करती है। या नवीनतम रिलीज़ से AppImage लें (chmod +x KRAKEN-*.AppImage, फिर इसे चलाएँ; ./KRAKEN-*.AppImage kraken --help कमांड लाइन चलाता है), या Arch Linux पर AUR से kraken-workbench-bin इंस्टॉल करें। Windows और macOS आर्काइव भी रिलीज़ पेज पर उपलब्ध हैं, और प्रयोगात्मक हैं (Status देखें)। Install में विवरण और स्रोत से बिल्ड की जानकारी है।

त्वरित शुरुआत

kraken project-create --binary /usr/bin/ls --project ~/kraken-projects/ls
kraken analyze --project ~/kraken-projects/ls
kraken list-functions --project ~/kraken-projects/ls --limit 20
kraken-gui                             # or open the app and pick the project

नए प्रोजेक्ट्स नेटिव इंजन का उपयोग करते हैं जब वह फ़ाइल खोल सकता है, अन्यथा वैकल्पिक Ghidra इंजन (Mach-O, अन्य प्रोसेसर, Windows डीबग जानकारी), जिसे kraken setup पहली बार उपयोग पर JDK के साथ डाउनलोड करता है। नेटिव इंजन पृष्ठ दोनों की तुलना करता है। corpus/bin/ में अभ्यास प्रोग्राम एक अच्छी शुरुआत हैं, और ट्यूटोरियल पहले सत्र के माध्यम से मार्गदर्शन करता है।

एक एजेंट कनेक्ट करें: claude mcp add kraken -- kraken mcp --project ~/kraken-projects/ls।

स्रोत से

आपको Rust और एक C++ कंपाइलर की आवश्यकता है:

git clone https://github.com/Adam-AtlasSoftware/kraken && cd kraken
cargo build --release -p kraken-cli -p krakend -p kraken-gui -p engine-native -p kraken-emu
export PATH="$PWD/target/release:$PATH"
kraken setup --native                  # once: fetches the pinned sources, compiles the Sleigh files (about a minute)

दस्तावेज़ीकरण

ट्यूटोरियल: आपका पहला रिवर्स-इंजीनियरिंग सत्र से शुरू करें।

• इंस्टॉल करें और शुरुआत करें (टर्मिनल)
• रिवर्स इंजीनियरिंग में नए लोगों के लिए अवधारणाएँ
• अंतर्निहित सहायक (एक AI मॉडल या Claude Code जैसा टर्मिनल एजेंट) और इस कंप्यूटर पर स्थानीय मॉडल
• AI एजेंट्स को जोड़ना (MCP)
• CLI के साथ स्क्रिप्टिंग और Python
• सुरक्षा
• कमांड संदर्भ
• डिज़ाइन निर्णय

पुस्तक को mdbook build docs से बनाएँ। कमांड संदर्भ स्वतः उत्पन्न होता है: किसी कमांड को बदलने के बाद cargo xtask docs चलाएँ।

सुरक्षा मॉडल