Developer Setup on native OS

Please ensure that you have an email user from your preferred LEAP provider. If you don't have access to an existing LEAP provider, you can create an account at Bitmask mail demo provider. Details for developer installations on OSX and Debian distributions are explained below.

On OSX

First, you will need to install the following dependencies:

• Command Line Tools for MacOS
  • xcode-select --install should do it
• Python 2
  • we recommend Homebrew and then run brew install python
• Pip
• Virtualenv
• GPG tools
  • you can skip the generation of a new GPG key pair (but consider doing it, if you don't have one)
• npm
  • we recommend brew install npm

1. Install openssl

   $ brew install openssl
   export LDFLAGS="-L/usr/local/opt/openssl/lib"
   export CPPFLAGS="-I/usr/local/opt/openssl/include"
   

2. Clone the repository

   $ git clone https://github.com/pixelated/pixelated-user-agent.git
   $ cd pixelated-user-agent
   

3. This step will create a virtual environment and install the Pixelated User Agent. If you ever need to activate the virtual environment manually, you can use source ~/.venvs/pixua/bin/activate

   $ make install
   

4. This step will run the Pixelated User Agent against the Bitmask mail demo provider (or you can use your favorite LEAP provider)

   $ make run provider=mail.bitmask.net
   

On Debian distributions

This is the setup for developers. Please run the following commands:

$ curl https://raw.githubusercontent.com/pixelated/pixelated-user-agent/master/debian_setup.sh | bash
$ cd pixelated-user-agent && source ~/.virtualenv/user-agent-venv/bin/activate