{"id":15063993,"url":"https://github.com/nguyenanht/john-toolbox","last_synced_at":"2025-04-10T11:50:51.494Z","repository":{"id":38018885,"uuid":"349524109","full_name":"nguyenanht/john-toolbox","owner":"nguyenanht","description":"This is my own toolbox to explore data science","archived":false,"fork":false,"pushed_at":"2024-07-08T06:28:16.000Z","size":65402,"stargazers_count":4,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2025-03-24T10:38:52.674Z","etag":null,"topics":["data-science","machine-learning","pipeline","python","pytorch","scikit-learn"],"latest_commit_sha":null,"homepage":"https://nguyenanht.github.io/john-toolbox","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nguyenanht.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"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":"2021-03-19T18:45:52.000Z","updated_at":"2024-02-23T13:38:08.000Z","dependencies_parsed_at":"2024-09-25T00:10:00.145Z","dependency_job_id":"73a76eba-760d-4df0-b706-ee0d2cba8ae9","html_url":"https://github.com/nguyenanht/john-toolbox","commit_stats":{"total_commits":106,"total_committers":2,"mean_commits":53.0,"dds":"0.028301886792452824","last_synced_commit":"b6cd72e5371682e06d4a14e2e2bf21690108a7c1"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nguyenanht%2Fjohn-toolbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nguyenanht%2Fjohn-toolbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nguyenanht%2Fjohn-toolbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nguyenanht%2Fjohn-toolbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nguyenanht","download_url":"https://codeload.github.com/nguyenanht/john-toolbox/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248215192,"owners_count":21066619,"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":["data-science","machine-learning","pipeline","python","pytorch","scikit-learn"],"created_at":"2024-09-25T00:09:54.721Z","updated_at":"2025-04-10T11:50:51.475Z","avatar_url":"https://github.com/nguyenanht.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n\nWelcome to john_toolbox 👋\n\n\u003c/h1\u003e\n\n\n![Version](https://img.shields.io/badge/version-0.5.1-blue.svg?cacheSeconds=2592000)\n[![Documentation](https://img.shields.io/badge/documentation-yes-brightgreen.svg)](https://nguyenanht.github.io/john-toolbox/)\n![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-brightgreen.svg)\n![Licence](https://img.shields.io/badge/License-MIT-FFB600.svg)\n[![Downloads](https://static.pepy.tech/personalized-badge/john-toolbox?period=month\u0026units=international_system\u0026left_color=grey\u0026right_color=red\u0026left_text=Downloads/Month)](https://pepy.tech/project/john-toolbox)\n[![Downloads](https://static.pepy.tech/personalized-badge/john-toolbox?period=total\u0026units=international_system\u0026left_color=grey\u0026right_color=red\u0026left_text=Downloads/Total)](https://pepy.tech/project/john-toolbox)\n\n[![scikit-learn](https://img.shields.io/badge/scikit--learn-%23F7931E.svg?style=for-the-badge\u0026logo=scikit-learn\u0026logoColor=white)](https://github.com/scikit-learn/scikit-learn)\n[![Pandas](https://img.shields.io/badge/pandas-%23150458.svg?style=for-the-badge\u0026logo=pandas\u0026logoColor=white)](https://github.com/pandas-dev/pandas)\n[![NumPy](https://img.shields.io/badge/numpy-%23013243.svg?style=for-the-badge\u0026logo=numpy\u0026logoColor=white)](https://github.com/numpy/numpy)\n[![Poetry](https://img.shields.io/badge/poetry-%233B82F6.svg?style=for-the-badge\u0026logo=poetry\u0026logoColor=white)](https://github.com/python-poetry/poetry)\n[![PyTorch](https://img.shields.io/badge/PyTorch-%23EE4C2C.svg?style=for-the-badge\u0026logo=PyTorch\u0026logoColor=white)](https://github.com/pytorch/pytorch)\n\n\u003e This is my own toolbox to handle preprocessing production ready based on scikit-learn Pipeline but with more flexibility.\n### 🏠 [Homepage](https://github.com/nguyenanht/john-toolbox)\n\n# 💿 Installation with pip\n```sh\npip install john-toolbox\n```\n\n# 💡 How to use the package ?\n\nIf you want examples, please refer to [notebooks directory](https://github.com/nguyenanht/john-toolbox/tree/develop/notebooks). It contains tutorials on how to use the package and other useful tutorials to handle end to end machine learning project.\n\n# 🚧 Local development\n## 💣 Installation guide\n❗ by default, we install docker container with cpu only, if you want to install gpu mode :\n```sh\nmake env\n```\nComment in `.env` file at the root, the following lines :\n```dotenv\nDEVICE=cpu\nDOCKER_RUNTIME=runc\n```\nUncomment in `.env` file at the root, the following lines :\n```dotenv\n# DEVICE=gpu\n# DOCKER_RUNTIME=nvidia\n```\nthen :\n```sh\nmake install\n```\nif you want to use with local domain name, you need to generate certificate ssl in local development instead of url with port like `http://localhost:8885` :\n```sh\nmake stop ssl\n```\n## ✨ Usage\n### Start project :\n```sh\nmake start\n```\n### Stop project : \n```sh\nmake stop\n```\n### Display logs of specific service\n```sh\nmake logs svc=\"your_service_name_declared_in_docker_compose\"\n```\n\n### Go inside a docker container\n```sh\n./cli your_service_name_declared_in_docker_compose\n```\n\n### 🦸 Need help\n```sh\nmake help\n```\n### Url\n- Develop with Jupyter Notebook : https://nb.johntoolbox.localhost\n- Treafik (reverse proxy) : https://proxy.johntoolbox.localhost\n\n## Author\n👤 **Johnathan Nguyen**\n* GitHub: [@nguyenanht](https://github.com/{github_username})\n\n\n# Show your support\nGive a ⭐️ if this project helped you!\n\n# 🤝 Contributing\nContributions, issues and feature requests are welcome!\u003cbr /\u003eFeel free to check [issues page](https://github.com/nguyenanht/john-toolbox/issues).\n## How to contribute\n### Semantic Commit Messages\n\nEvery programmer in this project must respect a convention for every commit.\nThe CI will not let you merge your branch into Develop.\n\nSee how a minor change to your commit message style can make you a better programmer.\n\nFormat: `\u003ctype\u003e(\u003cscope\u003e): \u003csubject\u003e`\n\n`\u003cscope\u003e` is optional\n\n#### Example\n\n```\nfeat: add hat wobble\n^--^  ^------------^\n|     |\n|     +-\u003e Summary in present tense.\n|\n+-------\u003e Type: chore, docs, feat, fix, refactor, style, or test.\n```\n\nMore Examples:\n\n- `feat`: (new feature for the user, not a new feature for build script)\n- `fix`: (bug fix for the user, not a fix to a build script)\n- `docs`: (changes to the documentation)\n- `style`: (formatting, missing semicolons, etc.; no production code change)\n- `refactor`: (refactoring production code, e.g. renaming a variable)\n- `test`: (adding missing tests, refactoring tests; no production code change)\n- `chore`: (updating grunt tasks etc.; no production code change)\n\nReferences:\n\n- https://www.conventionalcommits.org/\n- https://seesparkbox.com/foundry/semantic_commit_messages\n- http://karma-runner.github.io/1.0/dev/git-commit-msg.html\n\n# Useful link\n- how to publish new version in pypi with poetry ? : https://johnfraney.ca/posts/2019/05/28/create-publish-python-package-poetry/\n- how to create a new release ? : https://www.atlassian.com/fr/git/tutorials/comparing-workflows/gitflow-workflow\n- how to generate docs : https://github.com/JamesALeedham/Sphinx-Autosummary-Recursion\n- how to deploy with github actions : https://blog.flozz.fr/2020/09/21/deployer-automatiquement-sur-github-pages-avec-github-actions/\n\n---\n_This README was created with the [markdown-readme-generator](https://github.com/pedroermarinho/markdown-readme-generator)_","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnguyenanht%2Fjohn-toolbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnguyenanht%2Fjohn-toolbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnguyenanht%2Fjohn-toolbox/lists"}