An AI-CyberSecurity Bot Based on OpenAI's Models. hackerbot is being trained to do various Cyber Security tasks. You can either run hackerBot in a docker container (the fast option) or install it locally

The easiest way to run hackerBot is to run it inside a docker container. Set your secrets and run the command below:

sudo docker run -w /home/hb/hackerbot/ \
-e SERPAPI_API_KEY=<SERPAPI_API_KEY> \
-e OPENAI_API_KEY=<OPENAI_API_KEY> \
-e CWTOOL_LOG_GROUPS=cloudtrail,vpcflow \
-e CWTOOL_REGION=us-east-1 \
-ti ahmedag/hackerbot python hb.py

Dockerfile is at docker/Dockerfile

Instead of using the docker image, you can set your own environment.

• Clone the repo

git clone https://github.com/Ahmed-AG/hackerbot.git

• Install prerequisites

pip install openai
pip install langchain
pip install chromadb
pip install google-search-results
pip install boto3
pip install tiktoken

• Set environment variables

export OPENAI_API_KEY=<YOUR_OPENAI_KEY>
export SERPAPI_API_KEY=<SERAPI_KEY>
export CWTOOL_LOG_GROUPS=<LOGGROUP1,LOGGROUP2>
export CWTOOL_REGION=<AWS REGION>

hackerBot will examine the first word of the user's input. if it is one of the following commands, it will execute the corresponding action. Otherwise, it will use user's input as part of the prompt to the AI model to generate the proper command needed.

python hb.py
hb>agent use cloudwatch to find out the IP addresses used by admin

python hb.py
hb>show me instances in us-east-2. display instance ID, instance name, and AMi in a table

python hb.py
hb>scan 8.8.8.8 for ports less than 1000 and run services scan

$ python hb.py
hb>cmd python --version
Python 3.10.8

To report a bug, request a feature, or submit a suggestion/feedback, please submit an issue through the GitHub repository: https://github.com/Ahmed-AG/hackerbot/issues/new

By default, hackerBot logs the human requests as well as the AI generated responses to a remote location. This is to enhance the skills. If you want to disable this feature run hackerBot with --stats-off

python hb.py --stats-off