Blame view

README.md 2.86 KB
8dcb6dfcb   Yannick Estève   first commit
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
  [![Build Status](https://travis-ci.com/kaldi-asr/kaldi.svg?branch=master)](https://travis-ci.com/kaldi-asr/kaldi)
  Kaldi Speech Recognition Toolkit
  ================================
  
  To build the toolkit: see `./INSTALL`.  These instructions are valid for UNIX
  systems including various flavors of Linux; Darwin; and Cygwin (has not been
  tested on more "exotic" varieties of UNIX).  For Windows installation
  instructions (excluding Cygwin), see `windows/INSTALL`.
  
  To run the example system builds, see `egs/README.txt`
  
  If you encounter problems (and you probably will), please do not hesitate to
  contact the developers (see below). In addition to specific questions, please
  let us know if there are specific aspects of the project that you feel could be
  improved, that you find confusing, etc., and which missing features you most
  wish it had.
  
  Kaldi information channels
  --------------------------
  
  For HOT news about Kaldi see [the project site](http://kaldi-asr.org/).
  
  [Documentation of Kaldi](http://kaldi-asr.org/doc/):
  - Info about the project, description of techniques, tutorial for C++ coding.
  - Doxygen reference of the C++ code.
  
  [Kaldi forums and mailing lists](http://kaldi-asr.org/forums.html):
  
  We have two different lists
  - User list kaldi-help
  - Developer list kaldi-developers:
  
  To sign up to any of those mailing lists, go to
  [http://kaldi-asr.org/forums.html](http://kaldi-asr.org/forums.html):
  
  
  Development pattern for contributors
  ------------------------------------
  
  1. [Create a personal fork](https://help.github.com/articles/fork-a-repo/)
     of the [main Kaldi repository](https://github.com/kaldi-asr/kaldi) in GitHub.
  2. Make your changes in a named branch different from `master`, e.g. you create
     a branch `my-awesome-feature`.
  3. [Generate a pull request](https://help.github.com/articles/creating-a-pull-request/)
     through the Web interface of GitHub.
  4. As a general rule, please follow [Google C++ Style Guide](https://google.github.io/styleguide/cppguide.html).
     There are a [few exceptions in Kaldi](http://kaldi-asr.org/doc/style.html).
     You can use the [Google's cpplint.py](https://raw.githubusercontent.com/google/styleguide/gh-pages/cpplint/cpplint.py)
     to verify that your code is free of basic mistakes.
  
  Platform specific notes
  -----------------------
  
  ### PowerPC 64bits little-endian (ppc64le)
  
  - Kaldi is expected to work out of the box in RHEL >= 7 and Ubuntu >= 16.04 with
    OpenBLAS, ATLAS, or CUDA.
  - CUDA drivers for ppc64le can be found at [https://developer.nvidia.com/cuda-downloads](https://developer.nvidia.com/cuda-downloads).
  - An [IBM Redbook](https://www.redbooks.ibm.com/abstracts/redp5169.html) is
    available as a guide to install and configure CUDA.
  
  ### Android
  
  - Kaldi supports cross compiling for Android using Android NDK, clang++ and
    OpenBLAS.
  - See [this blog post](http://jcsilva.github.io/2017/03/18/compile-kaldi-android/)
    for details.