Skip to content

Commit fb95ae8

Browse files
committed
Update README.md and requirementx.txt
1 parent 101f517 commit fb95ae8

File tree

2 files changed

+58
-0
lines changed

2 files changed

+58
-0
lines changed

README.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Tutorial on basic neural network concepts
2+
3+
## Getting-Started
4+
5+
You need to install the dependencies before running the notebooks.
6+
7+
### Using conda
8+
9+
If you don't have conda installed already and want to use conda for environment management, you can install the miniconda as [described here](https://docs.conda.io/projects/miniconda/en/latest/miniconda-install.html).
10+
11+
- Create a conda env with `conda create -n nn-tutorial python=3.10`
12+
- Activate the environment with `conda activate nn-tutorial`
13+
- Install the required packages via `pip install -r requirements.txt`.
14+
15+
### Using venv only
16+
17+
If you do not have conda installed:
18+
19+
Alternatively, you can create the virtual env with `venv` in the standard library
20+
21+
```bash
22+
python -m venv nn-tutorial
23+
```
24+
25+
and activate the env with $ source <venv>/bin/activate (bash) or C:> <venv>/Scripts/activate.bat (Windows)
26+
27+
Then, install the packages with pip within the activated environment
28+
29+
```bash
30+
python -m pip install -r requirements.txt
31+
```
32+
33+
Afterwards, you should be able to run the provided notebooks.
34+
35+
## Running the tutorial
36+
37+
After installing the package
38+
39+
You can start the jupyterlab in the terminal, and it will start a browser automatically
40+
41+
```bash
42+
jupyter lab
43+
```
44+
45+
Alternatively, you can use supported Editor to run the jupyter notebooks, e.g. with VS Code.
46+
47+
### Jupyter Notebooks
48+
49+
Use `cmd+Enter` to execute one cell block
50+
51+
### Part 1 Neural Network Basics
52+
53+
The first part of the tutorial is in `1-neural_networks.ipynb`.
54+
55+
### Part 2 MNIST Training
56+
57+
The second part of the tutorial is in `2-mnist_training.ipynb`

requirements.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,4 @@ numpy
55
scikit-learn
66
scikit-optimize
77
torch
8+
torchvision

0 commit comments

Comments
 (0)