{"id":27104362,"url":"https://github.com/mlengineershub/lazyteacher","last_synced_at":"2025-07-19T00:38:37.176Z","repository":{"id":240802113,"uuid":"784829129","full_name":"mlengineershub/LazyTeacher","owner":"mlengineershub","description":"End-To-End Machine Learning Project for Automatic Grades for Student Essays","archived":false,"fork":false,"pushed_at":"2024-07-06T10:16:28.000Z","size":86474,"stargazers_count":18,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-04-06T17:38:07.065Z","etag":null,"topics":["api-server","css","deep-learning","deployment","eda","end-to-end","endpoint","fastapi","html","huggingface","javascript","machine-learning","python","statistical-analysis","transformers"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","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/mlengineershub.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2024-04-10T16:29:45.000Z","updated_at":"2025-03-02T12:17:36.000Z","dependencies_parsed_at":"2024-07-06T11:41:01.654Z","dependency_job_id":null,"html_url":"https://github.com/mlengineershub/LazyTeacher","commit_stats":null,"previous_names":["mlengineershub/lazyteacher"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mlengineershub/LazyTeacher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlengineershub%2FLazyTeacher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlengineershub%2FLazyTeacher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlengineershub%2FLazyTeacher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlengineershub%2FLazyTeacher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mlengineershub","download_url":"https://codeload.github.com/mlengineershub/LazyTeacher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlengineershub%2FLazyTeacher/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265863793,"owners_count":23840888,"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":["api-server","css","deep-learning","deployment","eda","end-to-end","endpoint","fastapi","html","huggingface","javascript","machine-learning","python","statistical-analysis","transformers"],"created_at":"2025-04-06T17:32:54.515Z","updated_at":"2025-07-19T00:38:37.157Z","avatar_url":"https://github.com/mlengineershub.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Automatic Grades for Student Essays: End-to-End Machine Learning Project\r\n\r\nWelcome to our repository! This project demonstrates an end-to-end solution for automatically grading student essays using advanced machine learning techniques, from initial data analysis to deployment. Our application accepts an essay image and outputs the text and its corresponding grade, leveraging a fine-tuned transformer model available on the [Hugging Face platform](https://huggingface.co/ilanaliouchouche/gte-base-lazy-teacher).\r\n\r\n## Project Structure\r\n\r\nThe repository is organized into several key areas:\r\n\r\n- `app/`: Contains the user interface for essay submission and grading display.\r\n- `data/`: Datasets used in model training and evaluation.\r\n- `endpoints/`: FastAPI implementation for deploying machine learning models as endpoints.\r\n- `ml/`: Core machine learning code including exploratory data analysis, data preprocessing, and training scripts.\r\n\r\n### Detailed Contents\r\n\r\n1. **ML Folder:** Focuses on machine learning model development.\r\n   - `preprocessing/`: Data preprocessing techniques, including exploratory data analysis and sampling methods.\r\n   - `training/`: Model training scripts, exploring different machine learning algorithms and transformer models.\r\n   - `error_analysis/`: Banchmark and error analysis of the most relevant model.\r\n\r\n2. **Endpoints:** Contains FastAPI code for model deployment, allowing real-time essay grading.\r\n\r\n3. **App:** A user-friendly interface for submitting essays and receiving grades.\r\n\r\n## Getting Started\r\n\r\nTo get started with this project, clone the repository and install the required dependencies:\r\n\r\n```bash\r\ngit clone https://github.com/mlengineershub/LazyTeacher\r\ncd LazyTeacher\r\npip install -r requirements.txt\r\n```\r\n\r\nRefer to individual READMEs in each directory for more detailed instructions on running each component.\r\n\r\n## Global Architecture\r\n\r\n![Global Architecture](./rsrc/process.png)\r\n\r\nThis diagram illustrates the comprehensive workflow of our project, from data handling and model training to deployment and user interaction.\r\n\r\nHere is a look of our front end application :\r\n![Front](./rsrc/front.png)\r\n\r\n\r\n## How to Use\r\n\r\nNavigate through the project using the following links to understand and interact with the different components:\r\n\r\n- [ML Folder](https://github.com/mlengineershub/LazyTeacher/tree/main/ml)\r\n  - [Preprocessing Folder](https://github.com/mlengineershub/LazyTeacher/tree/main/ml/preprocessing)\r\n  - [Training Folder](https://github.com/mlengineershub/LazyTeacher/tree/main/ml/training)\r\n- [Endpoints](https://github.com/mlengineershub/LazyTeacher/tree/main/endpoints)\r\n- [App Interface](https://github.com/mlengineershub/LazyTeacher/tree/main/app)\r\n\r\n## Contributing\r\n\r\nWe encourage contributions to this project! Please consider the following steps to contribute:\r\n\r\n1. Fork the repository.\r\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`).\r\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`).\r\n4. Push to the branch (`git push origin feature/AmazingFeature`).\r\n5. Open a Pull Request.\r\n\r\n## Contact\r\n\r\n- Ilyes DJERFAF - [GitHub](https://github.com/ilyesdjerfaf)\r\n- Ilan Aliouchouche - [GitHub](https://github.com/ilanaliouchouche)\r\n\r\nWe hope you find this project useful and we welcome any contributions or feedback!\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlengineershub%2Flazyteacher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmlengineershub%2Flazyteacher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlengineershub%2Flazyteacher/lists"}