Skip to main content

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

  1. The CSV file is read using the pandas library.
  2. The first column (item names) and first row (headers) are removed before processing.
  3. Feature values are normalized using Min-Max scaling.
  4. Cosine similarity is calculated between items.
  5. 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

simple_recommender_rg-0.1.2.tar.gz (2.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

simple_recommender_rg-0.1.2-py3-none-any.whl (2.6 kB view details)

Uploaded Python 3

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

Hashes for simple_recommender_rg-0.1.2.tar.gz
Algorithm Hash digest
SHA256 d0b8265994d1b90939806bb946f8a11334ef5f3bfab53b216fffc24a989e4869
MD5 4289fd10d4eebf7f817738665b3f112a
BLAKE2b-256 7461631a0e445f398100bf15146ccc8aaa9d8d4aebee672176a7618ccf2cffa1

See more details on using hashes here.

File details

Details for the file simple_recommender_rg-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for simple_recommender_rg-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 dbe1b376b3cd09991d2e3855b8418b17bccbd3ebe3cae41fcf114c19fe69405c
MD5 714bfd7ac43394551905bedf65803bf5
BLAKE2b-256 4e3779bdda091ad77186947ee8dacb39892c8466c8d4efecc5cb4e2b4bd1198e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page