{"id":18368674,"url":"https://github.com/radanalyticsio/jiminy-modeler","last_synced_at":"2025-06-12T02:45:27.776Z","repository":{"id":72026951,"uuid":"106414054","full_name":"radanalyticsio/jiminy-modeler","owner":"radanalyticsio","description":"a framework for a spark based model creation service","archived":false,"fork":false,"pushed_at":"2024-06-01T22:01:21.000Z","size":53,"stargazers_count":1,"open_issues_count":8,"forks_count":5,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-06T17:37:41.440Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/radanalyticsio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-10T12:26:57.000Z","updated_at":"2018-06-02T03:37:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"e7bd38e8-3545-4518-b209-e15fdd68f812","html_url":"https://github.com/radanalyticsio/jiminy-modeler","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/radanalyticsio/jiminy-modeler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radanalyticsio%2Fjiminy-modeler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radanalyticsio%2Fjiminy-modeler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radanalyticsio%2Fjiminy-modeler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radanalyticsio%2Fjiminy-modeler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/radanalyticsio","download_url":"https://codeload.github.com/radanalyticsio/jiminy-modeler/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radanalyticsio%2Fjiminy-modeler/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259385036,"owners_count":22849375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T23:26:57.513Z","updated_at":"2025-06-12T02:45:27.751Z","avatar_url":"https://github.com/radanalyticsio.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jiminy Modeler\n\nThis is the model service for the [Jiminy project](https://radanalytics.io/applications/project-jiminy).\n\n## Setup\n\nTo setup the modeler, we assume that:\n\n1. A postgreSQL database has been set up, containing a table named `ratings` which holds the ratings information.\n2. MongoDB is running. This will be used to store the models created by the modeler.\n\nTo create the modeler service on OpenShift, first install the [oshinko](https://radanalytics.io/get-started) tools with\n\n```bash\noc create -f https://radanalytics.io/resources.yaml\n```\n\nThe modeler can then be launched using the following command:\n\n```bash\noc new-app --template oshinko-python-build-dc \\\n  -p GIT_URI=https://github.com/radanalyticsio/jiminy-modeler \\\n  -e MONGO_URI=mongodb://mongo:mongo@mongodb/models \\\n  -e DB_HOST=postgresql \\\n  -e DB_USER=postgres \\\n  -e DB_PASSWORD=postgres \\\n  -e DB_DBNAME=postgres \\\n  -p APP_FILE=app.py \\\n  -p APPLICATION_NAME=modeler\n```\n\nIn the command above, we assume that the postgreSQL database has associated username, database name and password `postgres`. These command line arguments can be amended appropriately to connect to the correct postgreSQL table, where the ratings are held.\n\nThe commands given above will launch the modeler. To watch the modeler, run:\n\n```bash\noc logs -f s/Modeler/modeler/\n```\n\n## Training the model\n\nThe command to launch the modeller, which is given above, will use a *fast* training method, meaning that parameters for the model are preselected. The default values are given by `rank = 6`, `lambda = 0.09` and `iteration = 2`. You can run the modeler with different parameter values using command line arguments. For example, if you wish to run at `rank = 3`, `lambda = 0.1` and `iteration = 4` the following command line arguments should be included in the model launch command:\n\n```bash\n  -e RANK_VAL = 3\n  -e LAMBDA_VAL = 0.1\n  -e ITS_VAL = 4\n```\n\nHowever, if you wish to complete a more robust training of the model, which optimises for model parameters, the following command line argument should be included in the model launch command:\n\n```bash\n   -e DISABLE_FAST_TRAIN = disable-fast-train\n```\n\nNote that this command will result in the model taking over half an hour to train on the latest [MovieLens Dataset](https://grouplens.org/datasets/movielens/latest/).\n\nIf fast train is disabled *and* command line parameter values are given, the command line parameter values will be ignored and the slow train method will be used. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradanalyticsio%2Fjiminy-modeler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fradanalyticsio%2Fjiminy-modeler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradanalyticsio%2Fjiminy-modeler/lists"}