Try it out!

Try out Athens

To quickly see Athens in action, follow these steps:

First, make sure you have Go v1.12+ installed, that GOPATH/bin is on your path, and that you have enabled the Go Modules feature.


export GO111MODULE=on


$env:GO111MODULE = "on"

Next, use git and Go to install and run the Athens proxy in a background process.

$ git clone
$ cd athens/cmd/proxy
$ go install
$ proxy &
[1] 37186
INFO[0000] Exporter not specified. Traces won't be exported
INFO[0000] Starting application at

Next, you will need to configure Go to use the Athens proxy!


export GOPROXY=


$env:GOPROXY = ""

Now, when you build and run this example application, go will fetch dependencies via Athens!

$ git clone
$ cd walkthrough
$ go run .
go: finding v1.0.0
handler: GET / [200]
handler: GET / [200]
go: downloading v1.0.0
handler: GET / [200]
The 🦁 says rawr!

The output from go run . includes attempts to find the dependency. Since the proxy was run in the background, you should also see output from Athens indicating that it is handling requests for the dependency.

This should give you an overview of what using Athens is like!

Fork me on GitHub