HMWCS commited on
Commit
377a558
·
1 Parent(s): ab3dbbe

chore: update .gitignore and create README.md

Browse files
Files changed (2) hide show
  1. .gitignore +1 -58
  2. README.md +55 -0
.gitignore CHANGED
@@ -21,69 +21,20 @@ ipython_config.py
21
  # Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
22
 
23
  # User-specific stuff
24
- .idea/**/workspace.xml
25
- .idea/**/tasks.xml
26
- .idea/**/usage.statistics.xml
27
- .idea/**/dictionaries
28
- .idea/**/shelf
29
-
30
- # AWS User-specific
31
- .idea/**/aws.xml
32
-
33
- # Generated files
34
- .idea/**/contentModel.xml
35
-
36
- # Sensitive or high-churn files
37
- .idea/**/dataSources/
38
- .idea/**/dataSources.ids
39
- .idea/**/dataSources.local.xml
40
- .idea/**/sqlDataSources.xml
41
- .idea/**/dynamic.xml
42
- .idea/**/uiDesigner.xml
43
- .idea/**/dbnavigator.xml
44
-
45
- # Gradle
46
- .idea/**/gradle.xml
47
- .idea/**/libraries
48
-
49
- # Gradle and Maven with auto-import
50
- # When using Gradle or Maven with auto-import, you should exclude module files,
51
- # since they will be recreated, and may cause churn. Uncomment if using
52
- # auto-import.
53
- # .idea/artifacts
54
- # .idea/compiler.xml
55
- # .idea/jarRepositories.xml
56
- # .idea/modules.xml
57
- # .idea/*.iml
58
- # .idea/modules
59
- # *.iml
60
- # *.ipr
61
 
62
  # CMake
63
  cmake-build-*/
64
 
65
- # Mongo Explorer plugin
66
- .idea/**/mongoSettings.xml
67
-
68
  # File-based project format
69
  *.iws
70
 
71
  # IntelliJ
72
  out/
73
 
74
- # mpeltonen/sbt-idea plugin
75
- .idea_modules/
76
-
77
  # JIRA plugin
78
  atlassian-ide-plugin.xml
79
 
80
- # Cursive Clojure plugin
81
- .idea/replstate.xml
82
-
83
- # SonarLint plugin
84
- .idea/sonarlint/
85
- .idea/sonarlint.xml # see https://community.sonarsource.com/t/is-the-file-idea-idea-idea-sonarlint-xml-intended-to-be-under-source-control/121119
86
-
87
  # Crashlytics plugin (for Android Studio and IntelliJ)
88
  com_crashlytics_export_strings.xml
89
  crashlytics.properties
@@ -91,16 +42,8 @@ crashlytics-build.properties
91
  fabric.properties
92
 
93
  # Editor-based HTTP Client
94
- .idea/httpRequests
95
  http-client.private.env.json
96
 
97
- # Android studio 3.1+ serialized cache file
98
- .idea/caches/build_file_checksums.ser
99
-
100
- # Apifox Helper cache
101
- .idea/.cache/.Apifox_Helper
102
- .idea/ApifoxUploaderProjectSetting.xml
103
-
104
 
105
 
106
  # VSCode
 
21
  # Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
22
 
23
  # User-specific stuff
24
+ .idea/
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
25
 
26
  # CMake
27
  cmake-build-*/
28
 
 
 
 
29
  # File-based project format
30
  *.iws
31
 
32
  # IntelliJ
33
  out/
34
 
 
 
 
35
  # JIRA plugin
36
  atlassian-ide-plugin.xml
37
 
 
 
 
 
 
 
 
38
  # Crashlytics plugin (for Android Studio and IntelliJ)
39
  com_crashlytics_export_strings.xml
40
  crashlytics.properties
 
42
  fabric.properties
43
 
44
  # Editor-based HTTP Client
 
45
  http-client.private.env.json
46
 
 
 
 
 
 
 
 
47
 
48
 
49
  # VSCode
README.md CHANGED
@@ -0,0 +1,55 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Waste Classification Application
2
+
3
+ This project is a web-based application that classifies waste materials from user-uploaded images. It identifies the type of waste (e.g., cardboard, glass, metal) and provides information on how to properly dispose of it.
4
+
5
+ ## Features
6
+
7
+ * **Image-based classification:** Upload an image of a waste item to have it automatically classified.
8
+ * **Multiple waste categories:** The application can identify a variety of waste materials.
9
+ * **Disposal information:** After classification, the app provides guidance on how to dispose of the identified waste material.
10
+ * **Web interface:** A user-friendly web interface built with Gradio makes the application easy to use.
11
+
12
+ ## How it works
13
+
14
+ The application uses a pre-trained Vision Transformer (ViT) model to perform the image classification. The model has been fine-tuned on a dataset of waste images to accurately identify different materials. The disposal information is retrieved from a knowledge base within the application.
15
+
16
+ ## Getting Started
17
+
18
+ ### Prerequisites
19
+
20
+ * Python 3.7+
21
+ * Pip
22
+
23
+ ### Installation
24
+
25
+ 1. Clone the repository:
26
+ ```bash
27
+ git clone https://github.com/your-username/waste-classification-app.git
28
+ ```
29
+ 2. Navigate to the project directory:
30
+ ```bash
31
+ cd waste-classification-app
32
+ ```
33
+ 3. Install the required dependencies:
34
+ ```bash
35
+ pip install -r requirements.txt
36
+ ```
37
+
38
+ ### Running the application
39
+
40
+ To start the application, run the following command:
41
+
42
+ ```bash
43
+ python app.py
44
+ ```
45
+
46
+ This will launch a Gradio web server. You can access the application by opening the provided URL in your web browser.
47
+
48
+ ## Project Structure
49
+
50
+ * `app.py`: The main application file, containing the Gradio interface and the classification logic.
51
+ * `classifier.py`: Handles the image classification using the pre-trained model.
52
+ * `config.py`: Contains configuration settings for the application, such as the model name and labels.
53
+ * `knowledge_base.py`: A simple knowledge base containing disposal information for different waste materials.
54
+ * `requirements.txt`: A list of the Python dependencies required to run the application.
55
+ * `test_images/`: A directory containing sample images for testing the application.