AdversarialDNN-Playground - GitLite

KO | EN

gitlite — search

#python #react #typescript #llm #golang #machine-learning #macos #awesome #cli #kubernetes #awesome-list #pytorch #mcp #ios

AdversarialDNN-Playground

(★ 131)

VizSec17: Web-based visualization tool for adversarial machine learning / LiveDemo

파일 탐색기

최종 버전 다운로드 (.zip)

- paper.pdf
- paperRevised_V2.pdf
- presentation.pdf
- cleverhans
- cleverhans_analyze.py
- fjsma_analyze.py
- run_experiment.sh
- tests.py
- images_to_generate.csv
- json_gen.py
- search_images.py
- - __init__.py
  - checkpoint
  - l0_model.py
  - linf_model.py
  - mnist-model.data-00000-of-00001
  - mnist-model.index
  - mnist-model.meta
  - mnist_model.py
  - seeds.json
- - bootstrap-slider.min.css
  - bootstrap-slider.min.js
  - custom.css
  - fgs-attack.png
  - image-picker
  - jsma-attack.png
- - base.html
  - fastgradientsign.html
  - fjsma.html
  - index.html
  - jsma.html
- __init__.py
- views.py
- vizscripts.js
.gitignore
.gitmodules
config.py
LICENSE
presentation.pdf
README.md
requirements.txt
run.py

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/QData/AdversarialDNN-Playground

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd AdversarialDNN-Playground

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Python

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip3 -r install requirements.txt

이 명령어를 터미널에 그대로 입력해 실행하세요.

pip3 install -r requirements.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

sudo -H pip install -r requirements.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Adversarial DNN Playground
==========================

Citation:
---------

```
@inproceedings{norton2017adversarial,
  title={Adversarial-Playground: A visualization suite showing how adversarial examples fool deep learning},
  author={Norton, Andrew P and Qi, Yanjun},
  booktitle={Visualization for Cyber Security (VizSec), 2017 IEEE Symposium on},
  pages={1--4},
  year={2017},
  organization={IEEE}
}
```

Reference Papers:
---------
[1] "Adversarial-Playground: A Visualization Suite Showing How Adversarial
  Examples Fool Deep Learning", Andrew P. Norton, Yanjun Qi, [arxiv](http://arxiv.org/abs/1708.00807) (this is a revised version of [1])
  Published in:  2017 IEEE Symposium on Visualization for Cyber Security (VizSec), [URL](http://ieeexplore.ieee.org/document/8062202/)

[2] "Adversarial Playground: A Visualization Suite for Adversarial Sample Generation", Norton, Andrew and Qi, Yanjun, [url](http://arxiv.org/abs/1706.01763)

This is Andrew Norton's capstone research work.  The goal is to perform a similar function to Google's TensorFlow Playground, but for evasion attacks in adversiaral machine learning.  It is a web service that enables the user to visualize the creation of adversarial samples to neural networks.

Screenshots and Demo
--------------------

Information regarding the various settings for each attack model may be found the [project slide set](https://github.com/QData/AdversarialDNN-Playground/blob/master/presentation.pdf) (see especially the *System Demonstration* section).

Installation
------------

There are git submodules in this repository; to clone all the needed files, please use:

```
git clone --recursive https://github.com/QData/AdversarialDNN-Playground.git
```

The primary requirements for this package are Python 3 with Tensorflow version 1.0.1 or greater.  The `requirements.txt` file contains a listing of the required Python packages; to install all requirements, run the following:

```
pip3 -r install requirements.txt
```

If the above command does not work, use the following:

```
pip3 install -r requirements.txt
```

Or use the following instead if need to sudo:
```
sudo -H pip  install -r requirements.txt
```

Use:
----

### To Deploy the webserver:

Once you've downloaded the repo, run `python3 run.py` :

```
$ cd AdversarialDNN-Playground-localDir
$ python3 run.py &       
```

Or run the following command to run the webapp in the background even when logged out from the server:
```
$ cd AdversarialDNN-Playground-localDir
$ nohup python3 run.py &        # run in background even when logged out
```

Now use your favorite explorer to navigate to `localhost:9000`  or 'your_server_url:9000'

### Modifying Seed Images
By default, we give the user the option of 11 seed images (one from each class 0 through 9, and one misclassified instance from the "9" class).  However, you may desire to select different images for your own instance of this tool.  It is quite easy to do so via the `json_gen.py` script in the [`utils`](https://github.com/QData/AdversarialDNN-Playground/tree/master/utils) directory.  Edit the `images_to_generate.csv` file to specify the indices into the MNIST dataset which interest you in the first column, and provide a human readable description in the second column.

After editing the `images_to_generate.csv` file, run:
```
$ python images_to_generate.csv
```

This will take a short amount of time, as it processes and classifies (using the pre-trained model) each seed image, and saves a `png` file of the image.  There are two items created as output, and they must be moved into proper locations in the `webapp` directories:
  - `seeds.json` : This contains each image and the classifier output as a JSON object; it goes in `/webapp/models`.
  - `imgs/` : This directory should be copied into the `webapp/static/` directory.

Run (or restart) the webserver, and the new options should be visible to the user.

Framework
---------
  - Python `Flask`-based server
    - Python backend provides access to TensorFlow
    - Integration with cleverhans is also possible
  - Front-end using JQuery and Bootstrap
    - Bootstrap for static visuals
      - Used Seiyria's [Bootstrap slider][bootstrap-slider]
    - Ploty.JS utilized for visualization

[bootstrap-slider]: https://github.com/seiyria/bootstrap-slider