ADB Chat is a LangChain Agent-based chat application that allows the user to execute Android Debug Bridge commands using a natural language chat interface.
Research Paper: ADB Chat: A Chat-based Langchain Agent for Android Forensics
- Clone this repository locally and install the requirements using pip
➜ pip install -r requirements.txt
- Install the Android Debug Bridge here: Android Debug Bridge Download
- At the bare minimum you need
/platform_toolson your computer, here is the direct download page: Platform Tools
- At the bare minimum you need
- Start up an
adbserver on your computer
➜ adb start-server
daemon not running; starting now at tcp:5037
daemon started successfully
- Start up the ADB Chat application
➜ streamlit run main.py
You can now view your Streamlit app in your browser.
Local URL: http://localhost:8501
Network URL: http://192.168.1.196:8501
- Enter your OpenAI API Key and output folder in the sidebar. Select a device and an OpenAI model to use.
- If your sidebar dropdown is empty and does not show any device serial numbers, try to follow the troubleshooting steps shown here: https://developer.android.com/tools/adb#Enabling
- You can also try restarting the
adbserver like so:
➜ adb kill-server
➜ adb start-server
- Make sure you are entering your OpenAI API Key correctly if you are seeing 400 forbidden errors
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.