2017-08-23 10:31:38 -07:00
# Cosmos SDK
2017-01-26 13:48:54 -08:00
2017-08-29 10:55:43 -07:00
2017-08-23 10:31:38 -07:00
[](https://github.com/cosmos/cosmos-sdk/releases/latest)
[](https://godoc.org/github.com/cosmos/cosmos-sdk)
[](https://cosmos.rocket.chat/)
[](https://github.com/cosmos/cosmos-sdk/blob/master/LICENSE)
Branch | Tests | Coverage | Report Card
----------|-------|----------|-------------
develop | [](https://circleci.com/gh/cosmos/cosmos-sdk/tree/develop) | [](https://codecov.io/gh/cosmos/cosmos-sdk) | [](https://goreportcard.com/report/github.com/cosmos/cosmos-sdk/tree/develop)
master | [](https://circleci.com/gh/cosmos/cosmos-sdk/tree/master) | [](https://codecov.io/gh/cosmos/cosmos-sdk) | [](https://goreportcard.com/report/github.com/cosmos/cosmos-sdk/tree/master)
2017-08-28 17:10:48 -07:00
The Cosmos SDK is the core framework for constructing
the atom tokens which will power [The Cosmos Network ](https://cosmos.network/ ). It is an [ABCI application ](https://github.com/tendermint/abci ) designed to be used with the [Tendermint consensus engine ](https://tendermint.com/ ) to form a Proof-of-Stake cryptocurrency. It also provides a general purpose framework
2017-07-21 05:23:45 -07:00
for extending the feature-set of the cryptocurrency by implementing plugins.
2017-01-26 13:48:54 -08:00
2017-08-28 17:10:48 -07:00
This SDK affords you all the tools you need to rapidly develop
robust blockchains and blockchain applications which are interoperable with The
Cosmos Hub. It is a blockchain development 'starter-pack' of common blockchain
modules while not enforcing their use thus giving maximum flexibility for
application customization. For example, do you require fees, how do you
want to log messages, do you enable IBC, do you even have a cryptocurrency?
2017-08-23 10:31:38 -07:00
Within this repository, the `basecoin` app serves as a reference implementation for how we build ABCI applications in Go, and is the framework in which we implement the [Cosmos Hub ](https://cosmos.network ). **It's easy to use, and doesn't require any forking** - just implement your plugin, import the libraries, and away
2017-07-21 05:23:45 -07:00
you go with a full-stack blockchain and command line tool for transacting.
2017-01-26 13:48:54 -08:00
2017-03-01 13:01:47 -08:00
## Prerequisites
2017-08-23 10:31:38 -07:00
* [golang ](https://golang.org/doc/install )
2017-03-01 13:01:47 -08:00
2017-01-26 13:48:54 -08:00
## Installation
2017-02-10 13:40:20 -08:00
```
2017-08-23 10:31:38 -07:00
go get -u github.com/cosmos/cosmos-sdk/cmd/basecoin
2017-02-10 13:40:20 -08:00
```
2017-03-13 14:23:05 -07:00
See the [install guide ](/docs/guide/install.md ) for more details.
2017-02-10 13:40:20 -08:00
2017-08-23 10:31:38 -07:00
## Guides
2017-01-29 12:48:28 -08:00
2017-08-23 10:31:38 -07:00
* Getting started with the [Basecoin basics ](/docs/guide/basecoin-basics.md )
* Learn to [use the plugin system ](/docs/guide/basecoin-plugins.md )
* More features of the [Basecoin tool ](/docs/guide/basecoin-tool.md )
* Learn how to use [Inter-Blockchain Communication (IBC) ](/docs/guide/ibc.md )
* See [more examples ](https://github.com/cosmos/cosmos-academy )
2017-01-29 15:23:50 -08:00
2017-04-26 21:54:56 -07:00
To deploy a testnet, see our [repository of deployment tools ](https://github.com/tendermint/tools ).
