{"id":22529829,"url":"https://github.com/4techsadiq/cgpa-calc","last_synced_at":"2025-03-28T04:45:13.987Z","repository":{"id":240781012,"uuid":"803445156","full_name":"4TechSadiq/CGPA-CALC","owner":"4TechSadiq","description":null,"archived":false,"fork":false,"pushed_at":"2024-06-26T15:06:58.000Z","size":61,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-02T05:42:42.495Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://cgpa-calc-chi.vercel.app","language":"CSS","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/4TechSadiq.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-05-20T18:29:27.000Z","updated_at":"2024-06-26T15:07:02.000Z","dependencies_parsed_at":"2024-05-20T22:06:30.598Z","dependency_job_id":"91e93e48-88b6-4217-915f-5d6e9a1ff963","html_url":"https://github.com/4TechSadiq/CGPA-CALC","commit_stats":null,"previous_names":["s4diq84/cgpa-calc","4techsadiq/cgpa-calc"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4TechSadiq%2FCGPA-CALC","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4TechSadiq%2FCGPA-CALC/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4TechSadiq%2FCGPA-CALC/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/4TechSadiq%2FCGPA-CALC/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/4TechSadiq","download_url":"https://codeload.github.com/4TechSadiq/CGPA-CALC/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245972668,"owners_count":20702720,"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-12-07T07:16:41.214Z","updated_at":"2025-03-28T04:45:13.961Z","avatar_url":"https://github.com/4TechSadiq.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CGPA Calc\n\n## Overview\nThis project is a CGPA (Cumulative Grade Point Average) calculator designed to help students calculate their CGPA both manually and automatically through image processing. The application is built using Flask and Python, with integrated image processing to extract marks from images.\n\n## Features\n- **Manual Calculation**: Manually input subject codes, credits, and marks to calculate CGPA.\n- **Automatic Calculation**: Upload images of marksheets for automatic data extraction and CGPA computation.\n- **User-Friendly Interface**: Simple and intuitive UI.\n- **Persistent Data**: Retains user input across sessions.\n\n## Installation\n1. Clone the repository:\n    ```sh\n    git clone https://github.com/S4DIQ84/CGPA-CALC.git\n    ```\n2. Navigate to the project directory:\n    ```sh\n    cd CGPA-CALC\n    ```\n3. Set up a virtual environment:\n    ```sh\n    python -m venv venv\n    ```\n4. Activate the virtual environment:\n    - On Windows:\n        ```sh\n        .\\venv\\Scripts\\activate\n        ```\n    - On macOS/Linux:\n        ```sh\n        source venv/bin/activate\n        ```\n5. Install the dependencies:\n    ```sh\n    pip install -r requirements.txt\n    ```\n\n## Usage\n1. Run the Flask application:\n    ```sh\n    flask run\n    ```\n2. Open your web browser and navigate to `http://127.0.0.1:5000/`.\n\n## Project Structure\n- `app.py`: Main application file with routes and logic.\n- `templates/`: Directory containing HTML templates.\n- `static/`: Directory for static files like CSS.\n- `cgpa.py`: Module for CGPA calculation logic.\n- `image_processing.py`: Module for extracting marks from images.\n\n## Routes\n- `/`: Home page.\n- `/upload`: Page to upload images for automatic calculation.\n- `/auto`: Handles image uploads and displays extracted data.\n- `/manual`: Form for manual CGPA calculation.\n- `/contact`: Contact page.\n\n## Modules Used\n- `flask`: Web framework for Python.\n- `PIL` (Pillow): Python Imaging Library for image processing.\n- `pandas`: Data analysis and manipulation tool.\n- `json`: JSON data handling.\n\n## Contributing\nFeel free to open issues or submit pull requests. Contributions are welcome!\n\n## License\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4techsadiq%2Fcgpa-calc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F4techsadiq%2Fcgpa-calc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F4techsadiq%2Fcgpa-calc/lists"}