You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@singa.apache.org by wa...@apache.org on 2015/09/16 06:19:53 UTC

[14/21] incubator-singa git commit: SINGA-68 Preparation for Release -- License etc.

SINGA-68 Preparation for Release -- License etc.

Add README.md.
Updated Readme.md with lincese, documentation, mail list description.


Project: http://git-wip-us.apache.org/repos/asf/incubator-singa/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-singa/commit/9cded5e3
Tree: http://git-wip-us.apache.org/repos/asf/incubator-singa/tree/9cded5e3
Diff: http://git-wip-us.apache.org/repos/asf/incubator-singa/diff/9cded5e3

Branch: refs/heads/tutorial
Commit: 9cded5e3a98b073138525fab1f5b3589e4040ed0
Parents: e1e8838
Author: xiezl <xi...@comp.nus.edu.sg>
Authored: Tue Sep 15 11:34:28 2015 +0800
Committer: wang sheng <wa...@gmail.com>
Committed: Wed Sep 16 11:09:25 2015 +0800

----------------------------------------------------------------------
 README.md | 61 ++++++++++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 49 insertions(+), 12 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-singa/blob/9cded5e3/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 6ccaac4..0777c6b 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,57 @@
-TODO
 
-##Apache SINGA
+#Apache SINGA
 
 Distributed deep learning system
 
-[Project Website](http://singa.incubator.apache.org)
+##Project Website
 
-All the details can be found in project website.
+All the details can be found in [Project Website](http://singa.incubator.apache.org), including the following instructions.
 
-The current code depends on the following external libraries:
-  * glog (New BSD)
-  * google-protobuf (New BSD)
-  * openblas (New BSD)
-  * zeromq (LGPLv3 + static link exception)
-  * czmq (Mozilla Public License Version 2.0)
-  * zookeeper (Apache 2.0)
-  * lmdb (OpenLDAP)
+##Mailing Lists
 
+* [Development Mailing List](mailto:dev-subscribe@singa.incubator.apache.org)([Archive](http://mail-archives.apache.org/mod_mbox/singa-dev/))
+* [Commits Mailing List](mailto:commits-subscribe@singa.incubator.apache.org)([Archive](http://mail-archives.apache.org/mod_mbox/singa-commits/))
 
+##Documentation
+
+Documentation is available in [Official Documentation](https://singa.incubator.apache.org/docs/overview.html#).
+
+##Building SINGA
+
+Just clone our github repo and execute following commands:
+
+	$ git clone git@github.com:apache/incubator-singa.git
+	$ cd incubator-singa
+	$ ./autogen.sh
+	$ ./configure
+	$ make
+
+You can also download the release package from the [Project Website](http://singa.incubator.apache.org) and follow the instructions on [Official Installation Guide](http://singa.incubator.apache.org/docs/installation.html).
+
+##Running an Example
+
+After installation, you may want to run an example to try SINGA.
+Let us train the [CNN model](http://papers.nips.cc/paper/4824-imagenet-classification-with-deep-convolutional-neural-networks) over the
+[CIFAR-10](http://www.cs.toronto.edu/~kriz/cifar.html) dataset without parallelism as an instance.
+The hyper-parameters are set following
+[cuda-convnet](https://code.google.com/p/cuda-convnet/). More details about this example are
+available at [CNN example](http://singa.incubator.apache.org/docs/cnn).
+
+We firstly download the dataset and create the data shard:
+
+	$ cd examples/cifar10/
+	$ make download
+	$ make create
+
+Then we start training:
+
+	$ cd ../../
+    $ ./bin/singa-run.sh -conf examples/cifar10/job.conf
+
+Now we just need to wait until it is done! About this part, you can also refer to the [Quick Start](http://singa.incubator.apache.org/docs/quick-start.html). 
+
+##LICENSE
+
+Apache Singa is licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
+
+For additional information, see the LICENSE and NOTICE files.