Whtery1087 commited on
Commit
4704540
1 Parent(s): ec12ab7

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +55 -0
README.md CHANGED
@@ -1,3 +1,58 @@
1
  ---
2
  license: mit
 
 
 
3
  ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
  license: mit
3
+ language:
4
+ - en
5
+ pipeline_tag: image-classification
6
  ---
7
+
8
+ ![CatDogVision](https://i.imgur.com/tFclZGq.png)
9
+
10
+ # Cat Dog Vision
11
+
12
+ CatDogVision is a project focused on recognizing images of dogs and cats using a neural network. This project was created for fun and educational purposes.
13
+
14
+ The goal of this project is to develop a deep learning model that can classify images as either "dog" or "cat" with high accuracy. It serves as a great opportunity to learn about neural networks and image classification.
15
+
16
+ > **Note:** For relatively good results, it is recommended to train the model for around 100 epochs.
17
+
18
+ ## 🔨 Requirements
19
+
20
+ - Python **3.11** or lower (⚠️ Maximum)
21
+ - Required Python libraries: Numpy, Tensorflow
22
+
23
+ ## 😊 Getting Started
24
+
25
+ 1. Clone this repository to your local machine.
26
+
27
+ 2. Ensure you have **Python 3.11** or lower installed.
28
+
29
+ 3. Install the necessary dependencies by running the following command:
30
+
31
+ - `pip install -r requirements.txt` - Install all required libraries.
32
+ - `python train.py` - Train your model.
33
+ - `python test.py` - Test your model.
34
+
35
+ 4. You can now start working with the project.
36
+
37
+ ## 💡 Usage
38
+
39
+ 1. Make sure to have your dataset of dog and cat images in the "data/train" directory.
40
+
41
+ 2. Customize the neural network model in the `train.py` file to suit your needs.
42
+
43
+ 3. Train the model by running:
44
+
45
+ 4. Once the model is trained, you can use it for image classification.
46
+
47
+ ## ⭐ Contributing
48
+
49
+ Any suggestions for changes are welcome, if you would like to know what else we would like to do in this project here is a link to the [todo list.](https://github.com/Whtery1087/CatDogVision/blob/main/TODO.md)
50
+
51
+ ## 📜 Credits
52
+
53
+ This project is made possible with the help of the following libraries:
54
+
55
+ - Numpy: [https://numpy.org/](https://numpy.org/)
56
+ - Tensorflow: [https://www.tensorflow.org/](https://www.tensorflow.org/)
57
+
58
+ Feel free to explore and expand upon this project for your own learning and enjoyment!