{"id":50261199,"url":"https://github.com/peterdsp/greek-salary-calculator-cli","last_synced_at":"2026-05-27T10:04:40.285Z","repository":{"id":251358747,"uuid":"837169474","full_name":"peterdsp/greek-salary-calculator-cli","owner":"peterdsp","description":"A Python CLI tool to calculate net-gross salary in Greece. Includes employer and employee insurance contributions, income tax, and tax credits based on number of children. Get detailed monthly and annual breakdowns effortlessly!","archived":false,"fork":false,"pushed_at":"2024-08-02T12:06:17.000Z","size":11,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-08-03T13:20:53.877Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/peterdsp.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":"2024-08-02T11:09:11.000Z","updated_at":"2024-08-02T16:47:03.000Z","dependencies_parsed_at":"2024-08-02T13:30:54.394Z","dependency_job_id":null,"html_url":"https://github.com/peterdsp/greek-salary-calculator-cli","commit_stats":null,"previous_names":["peterdsp/greek-salary-calculator-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/peterdsp/greek-salary-calculator-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterdsp%2Fgreek-salary-calculator-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterdsp%2Fgreek-salary-calculator-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterdsp%2Fgreek-salary-calculator-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterdsp%2Fgreek-salary-calculator-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/peterdsp","download_url":"https://codeload.github.com/peterdsp/greek-salary-calculator-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterdsp%2Fgreek-salary-calculator-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33560734,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":"2026-05-27T10:04:40.228Z","updated_at":"2026-05-27T10:04:40.279Z","avatar_url":"https://github.com/peterdsp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🇬🇷 Greek Salary Calculator CLI 🇬🇷\n\n### Calculate your net salary in Greece for 2023 effortlessly!\n\n![Salary Calculator](https://img.shields.io/badge/Salary%20Calculator-Python-blue.svg)\n![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)\n![Contributions Welcome](https://img.shields.io/badge/Contributions-Welcome-brightgreen.svg)\n\n---\n\n## 🚀 Introduction\n\nWelcome to the **Greek Salary Calculator CLI**! This Python tool helps you calculate your net monthly and annual salary in Greece for the tax year 2023. It takes into account:\n\n- Employer and employee insurance contributions\n- Income tax\n- Tax credits based on the number of children\n\nYou can use it as a CLI tool or through a REST API.\n\n---\n\n## 🛠️ Features\n\n- **Employer Contributions**: Automatically calculated based on the gross salary.\n- **Employee Insurance Contributions**: Deducted before calculating the taxable income.\n- **Income Tax**: Applied on a graduated basis according to Greek tax law.\n- **Tax Credits**: Adjusted based on the number of children.\n- **Detailed Salary Breakdown**: Outputs gross and net monthly and annual salaries.\n\n---\n\n## 💻 How to Run the CLI\n\n1.  **Clone the repository**:\n\n    ```sh\n    git clone https://github.com/peterdsp/greek-salary-calculator-cli.git\n    ```\n\n2.  **Navigate to the project directory**:\n\n    ```sh\n    cd greek-salary-calculator-cli\n    ```\n\n3.  **Install the dependencies**:\n\n    ```sh\n    pip install -r requirements.txt\n    ```\n\n4.  **Run the application**:\n    ```sh\n    python ng_salary_calculator.py\n    ```\n\n---\n\n## 🌐 How to Use the REST API\n\n1.  **Navigate to the project directory**:\n\n    ```sh\n    cd greek-salary-calculator-cli\n    ```\n\n2.  **Install the dependencies**:\n\n    ```sh\n    pip install -r requirements.txt\n    ```\n\n3.  **Run the Flask application**:\n\n    ```sh\n    python ng_salary_calculator_api.py\n    ```\n\n4.  **Send a POST request to the API**:\n    - URL: `http://127.0.0.1:5000/calculate_net_salary`\n    - Body:\n      ```json\n      {\n        \"gross_monthly_salary\": 2000,\n        \"num_children\": 2\n      }\n      ```\n\n### Example CURL Command\n\n```sh\ncurl -X POST http://127.0.0.1:5000/calculate_net_salary -H \"Content-Type: application/json\" -d '{\"gross_monthly_salary\": 2000, \"num_children\": 2}'\n```\n\n### Example Response\n\n```json\n{\n  \"gross_monthly_salary\": 2000.0,\n  \"gross_annual_salary\": 28000.0,\n  \"net_monthly_salary\": 1457.29,\n  \"net_annual_salary\": 20401.08\n}\n```\n\n---\n\n## Explanation of the Calculation\n\n1.  **Gross Monthly Salary**: The starting salary provided by the user.\n2.  **Annual Gross Salary**: Calculated as `gross_monthly_salary * 14` since there are 14 monthly payments in the year. 3. **Employee's Insurance Contribution**: Calculated based on whether the gross salary exceeds the insurable earnings ceiling. 4. **Annual Insurance Contribution**: The monthly insurance contribution multiplied by 14. 5. **Annual Taxable Income**: The gross annual salary minus the annual insurance contribution. 6. **Total Tax**: Calculated based on the taxable income using the given tax brackets and rates. 7. **Tax Credit**: Based on the number of children and reduced by income above €12,000. 8. **Final Tax**: The total tax reduced by the tax credit. 9. **Net Annual Income**: The gross annual salary minus the insurance contributions and final tax. 10. **Net Monthly Income**: The net annual income divided by 14.\n\n    ***\n\n## 🤝 Contributing\n\nContributions are welcome! Feel free to open an issue or submit a pull request.\n\n---\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🌟 Acknowledgements\n\nSpecial thanks to the developers and contributors who have made this project possible.\n\n---\n\n## 📧 Contact\n\nFor any questions, please contact us at [info@peterdsp.dev](mailto:info@peterdsp.dev).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterdsp%2Fgreek-salary-calculator-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeterdsp%2Fgreek-salary-calculator-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterdsp%2Fgreek-salary-calculator-cli/lists"}