zayeem00 commited on
Commit
5314f4d
Β·
verified Β·
1 Parent(s): 1a20651

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +74 -2
README.md CHANGED
@@ -1,5 +1,5 @@
1
  ---
2
- title: Product Recommender
3
  emoji: πŸ“ˆ
4
  colorFrom: green
5
  colorTo: yellow
@@ -8,6 +8,78 @@ sdk_version: 4.36.1
8
  app_file: app.py
9
  pinned: false
10
  license: apache-2.0
 
 
11
  ---
 
12
 
13
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: AI Smart Shopper
3
  emoji: πŸ“ˆ
4
  colorFrom: green
5
  colorTo: yellow
 
8
  app_file: app.py
9
  pinned: false
10
  license: apache-2.0
11
+ thumbnail: >-
12
+ https://cdn-uploads.huggingface.co/production/uploads/66634b560ab8b63cbbdc9092/rCNFavmF-bBMO_YI5mEoR.jpeg
13
  ---
14
+ # AI Smart Shopper
15
 
16
+ AI Smart Shopper is an AI-powered product recommendation system that leverages OpenAI's language models and Pinecone's vector database for generating contextual recommendations. The system provides an intuitive interface for uploading product catalogs and querying product recommendations.
17
+
18
+ ## Features
19
+
20
+ - **Product Catalog Management**: Upload product catalogs via CSV files.
21
+ - **Product Recommendations**: Generate recommendations based on user queries.
22
+ - **Contextual Messaging**: Generate contextual messages based on user queries and recommended products.
23
+ - **User-Friendly Interface**: A sleek, easy-to-use interface built with Gradio.
24
+
25
+ ## Getting Started
26
+
27
+ ### Prerequisites
28
+
29
+ Ensure you have the following installed:
30
+
31
+ - Python 3.7 or higher
32
+ - pip (Python package installer)
33
+
34
+ ### Installation
35
+
36
+ 1. Clone the repository:
37
+
38
+ git clone https://github.com/your-username/ai-smart-shopper.git
39
+
40
+ cd ai-smart-shopper
41
+
42
+ 3. Create a virtual environment and activate it:
43
+
44
+ python -m venv venv
45
+
46
+ source venv/bin/activate # On Windows, use `venv\Scripts\activate`
47
+
48
+ 5. Install the required packages:
49
+
50
+ pip install -r requirements.txt
51
+
52
+ 6. Running the Application:
53
+
54
+ Python app.py
55
+
56
+
57
+ ### Usage
58
+
59
+ - **API Keys**: Enter your OpenAI and Pinecone API keys along with the Pinecone environment.
60
+ - **Upload Catalog**: Upload your product catalog in CSV format. The CSV should contain the following columns: product_id, product_name, description, image_url.
61
+ - **Get Recommendations**: Enter a query to get product recommendations. The system will display a list of recommended products along with a contextual message.
62
+
63
+ ## Dependencies
64
+
65
+ OpenAI
66
+
67
+ Pinecone
68
+
69
+ Pandas
70
+
71
+ Gradio
72
+
73
+ ## Contributing
74
+
75
+ Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.
76
+
77
+ ## License
78
+
79
+ This project is licensed under the apache 2.0 License. See the LICENSE file for details.
80
+
81
+ ## Acknowledgements
82
+
83
+ Thanks to OpenAI and Pinecone for their amazing APIs.
84
+
85
+ Thanks to the Gradio team for the easy-to-use UI framework.