/akash

a secure, transparent, and peer-to-peer cloud computing network

Primary LanguageGoApache License 2.0Apache-2.0

Akash - Decentralized Serverless Network

tests simulations codecov

Go Report Card License

Akash

Akash is a secure, transparent, and decentralized cloud computing marketplace that connects those who need computing resources (tenants) with those that have computing capacity to lease (providers).

For a high-level overview of the Akash protocol and network economics, check out the whitepapers; a detailed protocol definition can be found in the design documentation; and the target workload definition spec is here.

Branching and Versioning

The master branch contains new features and is under active development; the mainnet/main branch contains the current, stable release.

  • stable releases will have even minor numbers ( v0.8.0 ) and be cut from the mainnet/main branch.
  • unstable releases will have odd minor numbers ( v0.9.0 ) and be cut from the master branch.

Akash Suite

Akash Suite is the reference implementation of the Akash Protocol. Akash is an actively-developed prototype currently focused on the distributed marketplace functionality.

The Suite is composed of one binary, akash, which contains a (tendermint-powered) blockchain node that implements the decentralized exchange as well as client functionality to access the exchange and network data in general.

Get Started with Akash

The easiest way to get started with Akash is by trying Testnet. Sign up here to get started.

Join the Community

Official blog and documentation

Supported platforms

Platform Arch Status
Darwin (aka MacOS) amd64 Supported
Linux amd64 Supported
Linux arm64 (aka aarch64) Supported
Linux armhf GOARM=5,6,7 ⚠️ Not supported
Windows amd64 ⚠️ Experimental

Installing

The latest binary release can be installed with Homebrew:

$ brew tap ovrclk/tap
$ brew install akash

Or GoDownloader:

$ curl -sSfL https://raw.githubusercontent.com/ovrclk/akash/master/godownloader.sh | sh

Or install a specific version with GoDownloader

$ curl -sSfL https://raw.githubusercontent.com/ovrclk/akash/master/godownloader.sh | sh -s -- v0.7.8

Roadmap and contributing

Akash is written in Golang and is Apache 2.0 licensed - contributions are welcomed whether that means providing feedback, testing existing and new feature or hacking on the source.

To become a contributor, please see the guide on contributing

Building from Source

Dependencies

Akash is developed and tested with golang 1.15.6+. Building requires a working golang installation, a properly set GOPATH, and $GOPATH/bin present in $PATH.

Most golang libraries will be installed via go modules, however the following packages:

github.com/vektra/mockery/.../
k8s.io/code-generator/...
sigs.k8s.io/kind
golang.org/x/tools/cmd/stringer

will be installed globally with their binaries placed in $GOPATH/bin by make devdeps-install.

Building

go get -d github.com/ovrclk/akash
cd $GOPATH/src/github.com/ovrclk/akash
make deps-install
make

# dev environment only:
make setup-devenv

Running

We use thin integration testing environments to simplify the development and testing process. We currently have two environments:

  • Single node: simple (no workloads) single node running locally.
  • Single node with workloads: single node and provider running locally, running workloads within a virtual machine.
  • full k8s: same as above but with node and provider running inside Kubernetes.