2018-04-02 10:21:34 -07:00
# Cosmos SDK
![banner ](docs/graphics/cosmos-sdk-image.png )
[![version ](https://img.shields.io/github/tag/cosmos/cosmos-sdk.svg )](https://github.com/cosmos/cosmos-sdk/releases/latest)
2018-07-10 17:34:39 -07:00
[![CircleCI ](https://circleci.com/gh/cosmos/cosmos-sdk/tree/master.svg?style=shield )](https://circleci.com/gh/cosmos/cosmos-sdk/tree/master)
[![codecov ](https://codecov.io/gh/cosmos/cosmos-sdk/branch/master/graph/badge.svg )](https://codecov.io/gh/cosmos/cosmos-sdk)
[![Go Report Card ](https://goreportcard.com/badge/github.com/cosmos/cosmos-sdk )](https://goreportcard.com/report/github.com/cosmos/cosmos-sdk)
[![license ](https://img.shields.io/github/license/cosmos/cosmos-sdk.svg )](https://github.com/cosmos/cosmos-sdk/blob/master/LICENSE)
[![LoC ](https://tokei.rs/b1/github/cosmos/cosmos-sdk )](https://github.com/cosmos/cosmos-sdk)
2018-04-02 10:21:34 -07:00
[![API Reference](https://godoc.org/github.com/cosmos/cosmos-sdk?status.svg
)](https://godoc.org/github.com/cosmos/cosmos-sdk)
2018-06-16 23:01:22 -07:00
[![riot.im ](https://img.shields.io/badge/riot.im-JOIN%20CHAT-green.svg )](https://riot.im/app/#/room/#cosmos-sdk:matrix.org)
2018-04-02 10:21:34 -07:00
2018-06-16 19:23:06 -07:00
The Cosmos-SDK is a framework for building blockchain applications in Golang.
It is being used to build `Gaia` , the first implementation of the [Cosmos Hub ](https://cosmos.network ),
**WARNING**: The SDK has mostly stabilized, but we are still making some
breaking changes.
2018-04-02 10:21:34 -07:00
2018-07-10 17:34:39 -07:00
**Note**: The `master` branch is an active development branch. For the latest
release, see the [release page ](https://github.com/cosmos/cosmos-sdk/releases ).
2018-05-16 07:32:25 -07:00
**Note**: Requires [Go 1.10+ ](https://golang.org/dl/ )
2018-04-02 10:21:34 -07:00
2018-06-16 19:23:06 -07:00
## Gaia Testnet
2018-06-11 11:35:12 -07:00
For more information on connecting to the testnet, see
[cmd/gaia/testnets ](/cmd/gaia/testnets )
For the latest status of the testnet, see the [status
2018-06-11 11:37:05 -07:00
file](/cmd/gaia/testnets/STATUS.md).
2018-06-11 11:35:12 -07:00
2018-06-16 19:23:06 -07:00
## Install
2018-04-06 06:55:49 -07:00
2018-06-16 19:23:06 -07:00
See the [install instructions ](/docs/install.md )
2018-04-02 10:21:34 -07:00
2018-06-16 19:23:06 -07:00
## Quick Start
2018-04-02 10:21:34 -07:00
2018-07-28 10:54:37 -07:00
- [Documentation ](https://cosmos.network/docs/ )
2018-06-16 21:18:24 -07:00
- [Examples ](/examples )
2018-07-28 10:54:37 -07:00
- [Cosmos Hub Specification ](https://cosmos.network/docs/spec/ )
<!-- -
uncomment once the godocs improve
- [Godocs for API referrence ](https://godoc.org/github.com/cosmos/cosmos-sdk )
-->
2018-04-13 02:47:46 -07:00
## Disambiguation
This Cosmos-SDK project is not related to the [React-Cosmos ](https://github.com/react-cosmos/react-cosmos ) project (yet). Many thanks to Evan Coury and Ovidiu (@skidding) for this Github organization name. As per our agreement, this disambiguation notice will stay here.