To quickly see Athens in action, follow these steps:
$env:GO111MODULE = "on"
Next, use git and Go to install and run the Athens proxy in a background process.
$ git clone https://github.com/gomods/athens $ cd athens/cmd/proxy $ go install $ proxy &  37186 INFO Exporter not specified. Traces won't be exported INFO Starting application at http://127.0.0.1:3000
Next, you will need to configure Go to use the Athens proxy!
$env:GOPROXY = "http://127.0.0.1:3000"
Now, when you build and run this example application, go will fetch dependencies via Athens!
$ git clone https://github.com/athens-artifacts/walkthrough.git $ cd walkthrough $ go run . go: finding github.com/athens-artifacts/samplelib v1.0.0 handler: GET /github.com/athens-artifacts/samplelib/@v/v1.0.0.info  handler: GET /github.com/athens-artifacts/samplelib/@v/v1.0.0.mod  go: downloading github.com/athens-artifacts/samplelib v1.0.0 handler: GET /github.com/athens-artifacts/samplelib/@v/v1.0.0.zip  The 🦁 says rawr!
The output from
go run . includes attempts to find the github.com/athens-artifacts/samplelib 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!