README.md

Encrypted Stochastic Gradient Descent

Encrypted stochastic gradient descent using secure two-party computation and the ABY framework.

Requirements

---

• A Linux distribution of your choice (ESGD was developed and tested with Debian 10).

• Required packages:

  • g++ (version >=8) or another compiler and standard library implementing C++17 including the filesystem library
  • make
  • cmake
  • libgmp-dev
  • libssl-dev
  • libboost-all-dev (version >= 1.66)

  Install these packages with your favorite package manager, e.g, sudo apt install <package-name>.

Building ESGD

---

1. Clone the git repository by running: git clone https://github.com/mbkma/encrypted-stochastic-gd.git
2. Init git submodules: git submodule update --init --recursive
3. Use CMake to configure the build: mkdir build && cd build && cmake ..
4. Call make -j5 in the build directory.

Example

---

To run ESGD via LAN on two different machines: Assuming Alice ip-adress is 111.111.11:
On Alice machine: ./main -r 0 -l 0.03 -a 111.111.11
On Bobs machine: ./main -r 1 -l 0.03 -a 111.111.11

To test ESGD on a single machine: Open two terminal windows.

In the first one type:

./main -r 0 -l 0.03

and in the second one:

./main -r 1 -l 0.03

The option -l refers to the stepsize used in the stochastic gradient descent algorithm.

Important Note

---

This software was developed for testing purposes only. It most certainly contains security flaws and performance issues.