README.en.md 2.5 KB
Newer Older
1 2
# Deep Learning with PaddlePaddle

3 4 5 6 7 8 9 10
1. [Fit a Line](http://book.paddlepaddle.org/01.fit_a_line/index.en.html)
1. [Recognize Digits](http://book.paddlepaddle.org/02.recognize_digits/index.en.html)
1. [Image Classification](http://book.paddlepaddle.org/03.image_classification/index.en.html)
1. [Word to Vector](http://book.paddlepaddle.org/04.word2vec/index.en.html)
1. [Understand Sentiment](http://book.paddlepaddle.org/05.understand_sentiment/index.en.html)
1. [Label Semantic Roles](http://book.paddlepaddle.org/06.label_semantic_roles/index.en.html)
1. [Machine Translation](http://book.paddlepaddle.org/07.machine_translation/index.en.html)
1. [Recommender System](http://book.paddlepaddle.org/08.recommender_system/index.en.html)
11

12
## Running the Book
G
gongweibao 已提交
13

Y
Yi Wang 已提交
14
This book you are reading is interactive -- each chapter can run as a Jupyter Notebook.
G
gongweibao 已提交
15

16
We packed Jupyter, PaddlePaddle, and all dependencies into a Docker image. So you don't need to install anything except Docker. If you are using Windows, please following [this instruction](https://www.docker.com/docker-windows).  If you are running Mac, please follow [this](https://www.docker.com/docker-mac). For various Linux distros, please refer to https://www.docker.com.  If you are using Windows or Mac, you might want to give Docker [more memory and CPUs/cores](http://stackoverflow.com/a/39720010/724872).
G
gongweibao 已提交
17

18
Just type
G
gongweibao 已提交
19 20

```bash
21
docker run -d -p 8888:8888 paddlepaddle/book
G
gongweibao 已提交
22 23
```

24
This command will download the pre-built Docker image from DockerHub.com and run it in a container.  Please direct your Web browser to http://localhost:8888 to read the book.
G
gongweibao 已提交
25

26
If you are living in somewhere slow to access DockerHub.com, you might try our mirror server docker.paddlepaddle.org:
G
gongweibao 已提交
27 28

```bash
29
docker run -d -p 8888:8888 docker.paddlepaddle.org/book
G
gongweibao 已提交
30 31
```

Y
Shorten  
Yi Wang 已提交
32
## Contribute
G
gongweibao 已提交
33

34
Your contribution is welcome!  Please feel free to file Pull Requests to add your chapter as a directory under `/pending`. Once it is going stable, the community would like to move it to `/`.
G
gongweibao 已提交
35

36
To write, run, and debug your chapters, you will need Python 2.x, Go >1.5. You can build the Docker image using [this script](https://github.com/PaddlePaddle/book/blob/develop/.tools/convert-markdown-into-ipynb-and-test.sh).
37
This tutorial is contributed by <a xmlns:cc="http://creativecommons.org/ns#" href="http://book.paddlepaddle.org" property="cc:attributionName" rel="cc:attributionURL">PaddlePaddle</a>, and licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License</a>.