A simple content-based recommender system
Project description
simple-recommender-rg
Description
simple-recommender-rg is a Python package that implements a simple content-based recommender system. It recommends items based on feature similarity using machine learning techniques.
This project is mainly intended for academic learning and mini-projects.
Installation
Use the package manager pip to install simple-recommender-rg.
pip install simple-recommender-rg
Usage
Enter the CSV filename followed by the .csv extension.
recommend sample.csv
To view usage help, use:
recommend -h
Example
A CSV file containing numeric feature values for different items.
| Item | Feature1 | Feature2 | Feature3 |
|---|---|---|---|
| A | 10 | 7 | 9 |
| B | 8 | 6 | 5 |
| C | 9 | 9 | 8 |
Working
- The CSV file is read using the pandas library.
- The first column (item names) and first row (headers) are removed before processing.
- Feature values are normalized using Min-Max scaling.
- Cosine similarity is calculated between items.
- Items are ranked based on similarity scores.
Output Table
| Item | Similarity Score | Rank |
|---|---|---|
| A | 1.000000 | 1 |
| C | 0.976532 | 2 |
| B | 0.845210 | 3 |
Other Notes
- The CSV file should not contain categorical (string) values.
- There should be no missing values in the dataset.
- This package is designed for educational purposes.
- The first column and first row are removed automatically before processing.
License
MIT License
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file simple_recommender_rg-0.1.2.tar.gz.
File metadata
- Download URL: simple_recommender_rg-0.1.2.tar.gz
- Upload date:
- Size: 2.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d0b8265994d1b90939806bb946f8a11334ef5f3bfab53b216fffc24a989e4869
|
|
| MD5 |
4289fd10d4eebf7f817738665b3f112a
|
|
| BLAKE2b-256 |
7461631a0e445f398100bf15146ccc8aaa9d8d4aebee672176a7618ccf2cffa1
|
File details
Details for the file simple_recommender_rg-0.1.2-py3-none-any.whl.
File metadata
- Download URL: simple_recommender_rg-0.1.2-py3-none-any.whl
- Upload date:
- Size: 2.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dbe1b376b3cd09991d2e3855b8418b17bccbd3ebe3cae41fcf114c19fe69405c
|
|
| MD5 |
714bfd7ac43394551905bedf65803bf5
|
|
| BLAKE2b-256 |
4e3779bdda091ad77186947ee8dacb39892c8466c8d4efecc5cb4e2b4bd1198e
|