-
Notifications
You must be signed in to change notification settings - Fork 42
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
psifertex
committed
Sep 13, 2024
1 parent
9f0d363
commit 30a5a3f
Showing
2 changed files
with
23 additions
and
23 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -28,8 +28,8 @@ | |
"version": "0.1.1", | ||
"author": "Jason Tang", | ||
"minimumbinaryninjaversion": 4000, | ||
"longdescription": "# BinAssist\nAuthor: **Jason Tang**\n\n_A plugin that provides LLM helpers to explain code and assist in RE._\n\n## Description:\n\nThis is a LLM plugin aimed at enabling the use of local LLM's (ollama, text-generation-webui, lm-studio, etc) for assisting with binary exploration and reverse engineering. It supports any OpenAI v1-compatible API. Recommended models are LLaMA-based models such as llama3.1:8b, but others should work as well.\n\nCurrent features include:\n* Explain the current function - Works at all IL levels.\n* Explain the current instruction - Works at all IL levels.\n* General query - Query the LLM directly from the UI.\n* Propose actions - Provide a list of proposed actions to apply.\n* Function calling - Allow agent to call functions to navigate the binary, rename functions and variables.\n* RLHF dataset generation - To enable model fine tuning.\n* RAG augmentation - Supports adding contextual documents to refine query effectiveness.\n* Settings to modify API host, key, model name and max tokens.\n\nFuture Roadmap:\n* Agentic assistant - Use Autogen or similar framework for self-guided binary RE.\n* Model fine tuning - Leverage the RLHF dataset to fine tune the model.\n\n## Quickstart\n\n* If necessary, `pip install -r requirements.txt` from the plugin directory.\n* Open Settings -> BinAssist.\n* Ensure the RLHF and RAG database paths are appropriate for your environment.\n* Point the API host to your prefered API provider and set the API key. \n* Load a binary.\n* Open BinAssist with the 'BA' sidebar icon and start exploring.\n\n## Screenshot\n![Screenshot](/res/screenshots.gif)\n\n## Homepage\nhttps://github.com/jtang613/BinAssist\n\n\n## Installation Instructions\n\n### Linux\n\nAn OpenAI compatible API is required. For local LLM support, use Ollama, LMStudio, Open-WebUI, Text-Generation-WebUI, etc.\n\n`pip install -r requirements.txt`\n\n### Windows\n\nUntested but should work. Submit an Issue or Pull Request for support.\n\n### Darwin\n\nUntested but should work. Submit an Issue or Pull Request for support.\n\n## Minimum Version\n\nThis plugin requires the following minimum version of Binary Ninja:\n\n* 3164\n\n\n\n## Required Dependencies\n\nThe following dependencies are required for this plugin:\n\n * pip - openai, pysqlite3, markdown, httpx, chromadb, sentence-transformers\n\n\n## License\n\nThis plugin is released under a MIT license.\n## Metadata Version\n\n2\n", | ||
"lastUpdated": 1726171547, | ||
"longdescription": "# BinAssist\nAuthor: **Jason Tang**\n\n_A plugin that provides LLM helpers to explain code and assist in RE._\n\n## Support Continued Improvements\n\n[![\"Buy Me A Beer\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/jtang613)\n\n## Description:\n\nThis is a LLM plugin aimed at enabling the use of local LLM's (ollama, text-generation-webui, lm-studio, etc) for assisting with binary exploration and reverse engineering. It supports any OpenAI v1-compatible API. Recommended models are LLaMA-based models such as llama3.1:8b, but others should work as well.\n\nCurrent features include:\n* Explain the current function - Works at all IL levels.\n* Explain the current instruction - Works at all IL levels.\n* General query - Query the LLM directly from the UI.\n* Propose actions - Provide a list of proposed actions to apply.\n* Function calling - Allow agent to call functions to navigate the binary, rename functions and variables.\n* RLHF dataset generation - To enable model fine tuning.\n* RAG augmentation - Supports adding contextual documents to refine query effectiveness.\n* Settings to modify API host, key, model name and max tokens.\n\nFuture Roadmap:\n* Agentic assistant - Use Autogen or similar framework for self-guided binary RE.\n* Model fine tuning - Leverage the RLHF dataset to fine tune the model.\n\n## Quickstart\n\n* If necessary, `pip install -r requirements.txt` from the plugin directory.\n* Open Settings -> BinAssist.\n* Ensure the RLHF and RAG database paths are appropriate for your environment.\n* Point the API host to your prefered API provider and set the API key. \n* Load a binary.\n* Open BinAssist with the 'BA' sidebar icon and start exploring.\n\n## Screenshot\n![Screenshot](/res/screenshots.gif)\n\n## Homepage\nhttps://github.com/jtang613/BinAssist\n\n\n## Installation Instructions\n\n### Linux\n\nAn OpenAI compatible API is required. For local LLM support, use Ollama, LMStudio, Open-WebUI, Text-Generation-WebUI, etc.\n\n`pip install -r requirements.txt`\n\n### Windows\n\nUntested but should work. Submit an Issue or Pull Request for support.\n\n### Darwin\n\nUntested but should work. Submit an Issue or Pull Request for support.\n\n## Minimum Version\n\nThis plugin requires the following minimum version of Binary Ninja:\n\n* 3164\n\n\n\n## Required Dependencies\n\nThe following dependencies are required for this plugin:\n\n * pip - openai, pysqlite3, markdown, httpx, chromadb, sentence-transformers\n\n\n## License\n\nThis plugin is released under a MIT license.\n## Metadata Version\n\n2\n", | ||
"lastUpdated": 1726230846, | ||
"projectUrl": "https://github.com/jtang613/BinAssist", | ||
"projectData": { | ||
"id": 837757379, | ||
|
@@ -98,8 +98,8 @@ | |
"releases_url": "https://api.github.com/repos/jtang613/BinAssist/releases{/id}", | ||
"deployments_url": "https://api.github.com/repos/jtang613/BinAssist/deployments", | ||
"created_at": "2024-08-03T23:56:37Z", | ||
"updated_at": "2024-09-12T20:05:47", | ||
"pushed_at": "2024-09-12T20:33:23Z", | ||
"updated_at": "2024-09-13T12:34:06", | ||
"pushed_at": "2024-09-13T12:33:44Z", | ||
"git_url": "git://github.com/jtang613/BinAssist.git", | ||
"ssh_url": "[email protected]:jtang613/BinAssist.git", | ||
"clone_url": "https://github.com/jtang613/BinAssist.git", | ||
|
@@ -153,10 +153,10 @@ | |
"subscribers_count": 2 | ||
}, | ||
"authorUrl": "https://github.com/jtang613", | ||
"packageUrl": "https://api.github.com/repos/jtang613/BinAssist/zipball/refs/tags/0.1.3", | ||
"packageShortUrl": "https://v35.us/ij7uvp2", | ||
"packageUrl": "https://api.github.com/repos/jtang613/BinAssist/zipball/refs/tags/0.1.4", | ||
"packageShortUrl": "https://v35.us/5q9bm8d", | ||
"path": "jtang613_BinAssist", | ||
"commit": "ac10c3e4c98eb8b758d26d7f4818c64bcdec68cb", | ||
"commit": "7383660fb2dcbb88ac5e44d02a82a4aef1e5b694", | ||
"minimumBinaryNinjaVersion": 0 | ||
}, | ||
{ | ||
|
@@ -581,8 +581,8 @@ | |
"svn_url": "https://github.com/ahaggard2013/binaryninja-ollama", | ||
"homepage": null, | ||
"size": 4437, | ||
"stargazers_count": 64, | ||
"watchers_count": 64, | ||
"stargazers_count": 65, | ||
"watchers_count": 65, | ||
"language": "Python", | ||
"has_issues": true, | ||
"has_projects": true, | ||
|
@@ -609,7 +609,7 @@ | |
"visibility": "public", | ||
"forks": 5, | ||
"open_issues": 0, | ||
"watchers": 64, | ||
"watchers": 65, | ||
"default_branch": "main", | ||
"permissions": { | ||
"admin": false, | ||
|
@@ -2346,16 +2346,16 @@ | |
"svn_url": "https://github.com/mrphrazer/reverser_ai", | ||
"homepage": "", | ||
"size": 828, | ||
"stargazers_count": 784, | ||
"watchers_count": 784, | ||
"stargazers_count": 785, | ||
"watchers_count": 785, | ||
"language": "Python", | ||
"has_issues": true, | ||
"has_projects": true, | ||
"has_downloads": true, | ||
"has_wiki": true, | ||
"has_pages": false, | ||
"has_discussions": false, | ||
"forks_count": 43, | ||
"forks_count": 44, | ||
"mirror_url": null, | ||
"archived": false, | ||
"disabled": false, | ||
|
@@ -2372,9 +2372,9 @@ | |
"web_commit_signoff_required": false, | ||
"topics": [], | ||
"visibility": "public", | ||
"forks": 43, | ||
"forks": 44, | ||
"open_issues": 2, | ||
"watchers": 784, | ||
"watchers": 785, | ||
"default_branch": "main", | ||
"permissions": { | ||
"admin": false, | ||
|
@@ -2384,7 +2384,7 @@ | |
"pull": true | ||
}, | ||
"temp_clone_token": "", | ||
"network_count": 43, | ||
"network_count": 44, | ||
"subscribers_count": 16 | ||
}, | ||
"authorUrl": "https://github.com/mrphrazer", | ||
|
@@ -5690,8 +5690,8 @@ | |
"svn_url": "https://github.com/binsync/binsync", | ||
"homepage": "https://binsync.net", | ||
"size": 8036, | ||
"stargazers_count": 564, | ||
"watchers_count": 564, | ||
"stargazers_count": 565, | ||
"watchers_count": 565, | ||
"language": "Python", | ||
"has_issues": true, | ||
"has_projects": true, | ||
|
@@ -5726,7 +5726,7 @@ | |
"visibility": "public", | ||
"forks": 37, | ||
"open_issues": 45, | ||
"watchers": 564, | ||
"watchers": 565, | ||
"default_branch": "main", | ||
"permissions": { | ||
"admin": false, | ||
|
@@ -23850,8 +23850,8 @@ | |
"svn_url": "https://github.com/lwerdna/keypatch_binja", | ||
"homepage": "", | ||
"size": 222, | ||
"stargazers_count": 12, | ||
"watchers_count": 12, | ||
"stargazers_count": 13, | ||
"watchers_count": 13, | ||
"language": "Python", | ||
"has_issues": true, | ||
"has_projects": true, | ||
|
@@ -23878,7 +23878,7 @@ | |
"visibility": "public", | ||
"forks": 3, | ||
"open_issues": 1, | ||
"watchers": 12, | ||
"watchers": 13, | ||
"default_branch": "master", | ||
"permissions": { | ||
"admin": false, | ||
|