SetupNNIDeveloperEnvironment.md 1.41 KB
Newer Older
1
**Set up NNI developer environment**
Gems Guo's avatar
Gems Guo committed
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
===
## Best practice for debug NNI source code

For debugging NNI source code, your development environment should be under Ubuntu 16.04 (or above) system with python 3 and pip 3 installed, then follow the below steps.

**1. Clone the source code**

Run the command
```
git clone https://github.com/Microsoft/nni.git
```
to clone the source code

**2. Prepare the debug environment and install dependencies**

Change directory to the source code folder, then run the command
```
make install-dependencies
```
to install the dependent tools for the environment

**3. Build source code**

Run the command
```
make build
```
to build the source code

**4. Install NNI to development environment**

Run the command
```
make dev-install
```
to install the distribution content to development environment, and create cli scripts

**5. Check if the environment is ready**

Darío Hereñú's avatar
Darío Hereñú committed
41
Now, you can try to start an experiment to check if your environment is ready.
Gems Guo's avatar
Gems Guo committed
42
43
44
45
For example, run the command
```
nnictl create --config ~/nni/examples/trials/mnist/config.yml
```
goooxu's avatar
goooxu committed
46
And open WebUI to check if everything is OK
Gems Guo's avatar
Gems Guo committed
47
48
49

**6. Redeploy**

50
After the code changes, use **step 3** to rebuild your codes, then the changes will take effect immediately.
Gems Guo's avatar
Gems Guo committed
51
52

---
Vipul Gupta's avatar
Vipul Gupta committed
53
At last, wish you have a wonderful day.
54
For more contribution guidelines on making PR's or issues to NNI source code, you can refer to our [CONTRIBUTING](./CONTRIBUTING.md) document.