Skip to content

RevEngAI Radare2 Plugin v2.0.3

Choose a tag to compare

@github-actions github-actions released this 10 Jun 19:45
· 9 commits to master since this release
699c0f6

RevEngAI Radare2 Plugin Release v2.0.3

This release contains the RevEngAI plugin for Radare2 with automated install scripts.

πŸ“¦ Downloads

Platform Download Contents
🐧 Linux reai-r2-linux.tar.gz Radare2 plugin + install script
🍎 macOS reai-r2-macos.tar.gz Radare2 plugin + install script
πŸͺŸ Windows reai-r2-windows.zip Radare2 plugin + install script

πŸ“‹ What's Included

Linux:

  • πŸ”Œ libreai_radare.so - Radare2 plugin
  • πŸ“š libreai.so - RevEngAI runtime library
  • πŸš€ install-linux.sh - Automated installer with rpath fixing
  • πŸ“– README.md - Detailed installation documentation

macOS:

  • πŸ”Œ libreai_radare.so - Radare2 plugin
  • πŸ“š libreai.dylib - RevEngAI runtime library
  • πŸš€ install-macos.sh - Automated installer with rpath fixing
  • πŸ“– README.md - Detailed installation documentation

Windows:

  • πŸ”Œ reai_radare.dll - Radare2 plugin
  • πŸ”Œ reai_radare.lib - Plugin import library
  • πŸ“š reai.dll + reai.lib - RevEngAI runtime library
  • 🌐 libcurl.dll + libcurl_imp.lib - HTTP client library
  • πŸš€ install-windows.ps1 - Automated installer with PATH setup
  • πŸ“– README.md - Detailed installation documentation

πŸš€ Installation (Recommended)

🎯 Use the included install scripts for best results:

Linux

# Download and extract
wget https://github.com/RevEngAI/reai-r2/releases/download/v2.0.3/reai-r2-linux.tar.gz
tar -xzf reai-r2-linux.tar.gz
cd reai-r2-linux

# Run automated installer (requires patchelf)
sudo apt install patchelf radare2  # Ubuntu/Debian
chmod +x install-linux.sh
./install-linux.sh

macOS

# Download and extract
curl -L -O https://github.com/RevEngAI/reai-r2/releases/download/v2.0.3/reai-r2-macos.tar.gz
tar -xzf reai-r2-macos.tar.gz
cd reai-r2-macos

# Run automated installer (requires Xcode tools)
brew install radare2  # if not already installed
xcode-select --install  # if not already installed
chmod +x install-macos.sh
./install-macos.sh

Windows

# Download and extract (PowerShell)
Invoke-WebRequest "https://github.com/RevEngAI/reai-r2/releases/download/v2.0.3/reai-r2-windows.zip" -OutFile "reai-r2-windows.zip"
Expand-Archive "reai-r2-windows.zip" -Force
cd reai-r2-windows

# Run automated installer
.\install-windows.ps1

πŸ› οΈ What The Install Scripts Do

The install scripts provide intelligent, platform-specific installation:

  • βœ… Install libraries to proper user directories (~/.local/lib/)
  • βœ… Install Radare2 plugin to $(radare2 -H R2_USER_PLUGINS)
  • βœ… Fix rpath/library paths so plugins can find dependencies
  • βœ… Set up environment with helper scripts for easy usage
  • βœ… Verify installation and provide clear success/error messages

πŸ“‹ Manual Installation (Advanced)

If you prefer manual installation or the scripts don't work:

Exact File Locations

Shared Libraries:

  • Linux: ~/.local/lib/libreai.so
  • macOS: ~/.local/lib/libreai.dylib
  • Windows: %USERPROFILE%\.local\bin\reai.dll + %USERPROFILE%\.local\lib\reai.lib

Radare2 Plugin:

  • All platforms: Copy to $(radare2 -H R2_USER_PLUGINS)

Windows Additional Dependencies:

  • libcurl.dll β†’ %USERPROFILE%\.local\bin\
  • libcurl_imp.lib β†’ %USERPROFILE%\.local\lib\
  • reai_radare.lib β†’ Plugin directory

⚠️ Important: On Unix systems, you may need to set environment variables:

export LD_LIBRARY_PATH="$HOME/.local/lib:$LD_LIBRARY_PATH"  # Linux
export DYLD_LIBRARY_PATH="$HOME/.local/lib:$DYLD_LIBRARY_PATH"  # macOS

βœ… Verification

After installation, verify the plugin works:

Radare2:

radare2 /bin/ls
[0x00000000]> reai help
# Should display RevEngAI plugin help

Check plugin loading:

radare2 -c "L" /bin/ls | grep reai
# Should show the loaded reai plugin

πŸ“ Configuration

Create a configuration file at ~/.creait:

api_key = YOUR_REVENGAI_API_KEY
host = https://api.reveng.ai

πŸ”§ Requirements

  • Radare2 5.9.8 or compatible version
  • Internet connection for RevEngAI API access
  • Valid RevEngAI API key from https://portal.reveng.ai

Platform-specific:

  • Linux: patchelf tool for rpath fixing (sudo apt install patchelf)
  • macOS: Xcode command line tools for rpath fixing (xcode-select --install)
  • Windows: PowerShell (included with Windows)

πŸ› Issues & Support

  • πŸ“‹ Installation issues: Check the install script output for detailed error messages
  • πŸ”§ Plugin not loading: Verify environment variables are set (see install script output)
  • 🌐 API issues: Verify your API key and configuration file
  • πŸ› Bug reports: https://github.com/RevEngAI/reai-r2/issues

πŸ” Troubleshooting

Plugin not found:

# Check plugin directory
radare2 -H R2_USER_PLUGINS
ls "$(radare2 -H R2_USER_PLUGINS)"

# Check if plugin file exists
ls -la "$(radare2 -H R2_USER_PLUGINS)"/libreai_radare.*

Library not found (Unix):

# macOS
otool -L ~/.local/lib/libreai.dylib
export DYLD_LIBRARY_PATH="$HOME/.local/lib:$DYLD_LIBRARY_PATH"

# Linux
ldd ~/.local/lib/libreai.so
export LD_LIBRARY_PATH="$HOME/.local/lib:$LD_LIBRARY_PATH"

Windows DLL issues:

# Check if DLLs are in PATH
where reai.dll
where libcurl.dll

# Add to PATH if needed
$env:PATH = "$env:USERPROFILE\.local\bin;$env:PATH"

What's Changed

Full Changelog: v2.0.2...v2.0.3