This is the Augur prototype. It is currently in alpha testing. Our installation procedures and other documentation will get better/easier as time goes on and we smooth out the rough edges! In the meantime, please email us or join us in #augur on FreeNode IRC if you have trouble installing or running the prototype.
- Python 2.7
- git
- pip
First, install Xcode command line tools. Then enter the following commands in the terminal:
$ git clone https://github.com/AugurProject/augur.git $ cd augur $ sudo pip install -r requirements.txt
Start the Augur client using augur_ctl
:
$ ./augur_ctl start
Try easy (but alpha) install with Docker
- build:
sudo docker build -t augur .
- run:
sudo docker run -p 9000:9000 augur
or...
So far, we have only tested augur on Ubuntu 12.04/14.04. If you've tested it on another Linux distro, let us know!
First, you will need to install a few background packages using apt-get
:
$ apt-get install git libpython-dev python-numpy python-leveldb $ pip2 install m3-cdecimal $ git clone https://github.com/AugurProject/augur.git $ cd augur $ pip install -r requirements.txt
Start the Augur client using augur_ctl
:
$ ./augur_ctl start
Windows installer: Augur_0.1.1.exe
After running the installer, click on your Start Menu, navigate to the Augur application folder, then click on Augur. A command window should appear, containing some debugging information, and saying that Augur is running on http://localhost:9000
. Open your web browser and enter http://localhost:9000
in the address bar, and you should be up and running.
Note: this installer has only been tested so far on Windows 7 (64-bit).
If you want to run the Augur source code on Windows, a few extra steps are required:
- First, make sure you have Python installed.
- You need to install a few dependencies: numpy, six, cdecimal and pip, which can all be found here. I recommend using Ctrl+F to find them. Make sure you get the newest one that matches your Python installation's architecture!
- Once those are installed, you need to download ez_setup.py (right click on the link and click "Save Target As" and save with the name ez_setup.py.) You should be able to double click this file if you have installed Python, and it will run and close on its own.
- Now you need to edit the
Path
environment variable. To do this, go to theStart menu
, right click onComputer
, click onAdvanced System Settings
in the upper left, clickEnvironment Variables
in the bottom right, then in theSystem Variables
section, scroll down till you seePath
. Click onPath
, and clickEdit...
. Press theHome
key to get to the start of the line, then addC:\Python27\Scripts;C:\Python27\;
to the start of the line and clickOK
. - Now go to http://aka.ms/vcpython27 to download and install the windows C compiler for use with pip.
- Finally, go back to the
Start Menu
typecmd
and pressEnter
, then typepip install flask flask-socketio
.
Run augur by going into the augur
directory and double-clicking on augur.py
.
Once augur is installed, navigate to http://localhost:9000
in your web browser, and you should see the augur interface. To fire up your local node, click the red "Node stopped" button, then "Start node". After your node starts, you will see the main interface.