Install

First, install GoGi

Emergent depends on GoGi, so first follow the installation instructions for it, including building the standard widgets example to make sure everything is working.

Then install emergent

The simplest way to install is via standard Go install procedures (at some point we may have binary packages, and are looking into the vendoring vgo stuff) -- something like this:

• If that doesn't work, here's some individual steps. First get the source:

> go get github.com/emer/emergent    # ignore any warnings about no go files, etc.

• Go to the examples/leabra25ra directory and make sure all dependencies are installed (and updated)

> cd ~/go/src/github.com/emer/emergent/examples/leabra25ra    # use `$GOPATH` instead of `~/go` if you have that set
> go get [-u] ./...    # the -u may be needed but will take a lot longer -- try without first..

• Important: IGNORE any error messages you see from go get (including "no go files..") -- the only thing that matters is what happens with go build! get somehow gets confused with a few things..

Mac

• You may get a bunch of warnings about "text-based stub file... libraries out of sync" -- these appear to be harmless and can safely be ignored. This appears to be a particular problem with recent xcode versions and no obvious remedy is currently available.

MacOs Mojave (10.14)

If you get any errors about not being able to find include files such as gl3.h or stdlib.h, e.g.,:

In file included from ../../../../../golang.org/x/mobile/gl/work.go:28:
./work.h:22:10: fatal error: 'OpenGL/gl3.h' file not found
#include <OpenGL/gl3.h>

Then first make sure you have xcode installed:

> xcode-select --install

and then you need to run this to install the header files in standard places:

> open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg