{"id":29774390,"url":"https://github.com/pncnmnp/grammatical","last_synced_at":"2025-07-27T08:07:31.721Z","repository":{"id":143635001,"uuid":"616472514","full_name":"pncnmnp/grammatical","owner":"pncnmnp","description":"Corrects the spelling and grammar of your text using ChatGPT","archived":false,"fork":false,"pushed_at":"2023-03-20T18:53:02.000Z","size":17,"stargazers_count":24,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-11T19:24:34.203Z","etag":null,"topics":["chatgpt","grammar","grammar-checker","grammar-correction","spelling-correction"],"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/pncnmnp.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}},"created_at":"2023-03-20T13:07:34.000Z","updated_at":"2025-05-19T04:59:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"beb206d2-5a64-42d4-91c9-9e2cfadc8a23","html_url":"https://github.com/pncnmnp/grammatical","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pncnmnp/grammatical","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pncnmnp%2Fgrammatical","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pncnmnp%2Fgrammatical/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pncnmnp%2Fgrammatical/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pncnmnp%2Fgrammatical/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pncnmnp","download_url":"https://codeload.github.com/pncnmnp/grammatical/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pncnmnp%2Fgrammatical/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265419533,"owners_count":23761845,"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":["chatgpt","grammar","grammar-checker","grammar-correction","spelling-correction"],"created_at":"2025-07-27T08:07:30.445Z","updated_at":"2025-07-27T08:07:31.716Z","avatar_url":"https://github.com/pncnmnp.png","language":"Python","funding_links":[],"categories":["\u003ca name=\"writing\"\u003e\u003c/a\u003eWriting"],"sub_categories":[],"readme":"# Grammatical\n\n\u003cimg alt=\"Pink Bubble Tea with cute eyes and smile, using a typewriter, digital art\" src=\"https://user-images.githubusercontent.com/24948340/226350030-912c9696-8bc2-4a70-8f26-966b2814528e.png\" width=\"256\"\u003e\n\n_Corrects the spelling and grammar of your text using ChatGPT._\n\n# Motivation\n\nI have been using this CLI tool internally for a while now. It is not only good at correcting spelling and grammar in your text, but it is also excellent at simplifying complex technical language. Additionally, it perfectly complements [Grammarly](https://www.grammarly.com/).\n\n# Install\n\n```bash\npython3 -m pip install grammatical\n```\n\n# Usage\n\nThis tool **requires access to the [OpenAI API](https://openai.com/pricing)**. It utilizes the `gpt-3.5-turbo` model. When the spelling and grammar have been corrected, the resulting text will be automatically copied to the clipboard.\n\n```bash\nUsage: grammatical [OPTIONS]\n\n  Corrects the spelling and grammar of your text using ChatGPT.\n\nOptions:\n  --text TEXT               Text input for grammar correction\n                            If --text flag is used, a prompt will be displayed to enter the text.\n                            By default, the most recent text from the clipboard will be used.\n\n  --api_key TEXT            OpenAI API Key\n                            By default, key from the OPENAI_API_KEY env var will be used.\n\n  --tone TEXT               Tone of the grammar correction  [default: \"social media\"]\n                            This can be tuned in based on the context of the text.\n                            E.g. \"formal/informal setting\", \"academia\", \"reddit\", etc.\n\n  --simplify                Simplify the text\n\n  -i, --input_format TEXT   Specify the input format  [default: text]\n                            Useful when working with files like LaTeX, Markdown.\n\n  -o, --output_format TEXT  Specify the output format  [default: text]\n                            Useful when working with files like LaTeX, Markdown.\n\n  --help                    Show this message and exit.\n```\n\n## Example\n\nUsing the defaults:\n\n```\n[09:34][~] # Text in clipboard: I walk to the store and I bought milk\n[09:34][~] grammatical\nModified Text:\n\"I walked to the store and bought milk.\"\nText copied to clipboard.\n[09:34][~]\n```\n\nWith options:\n\n```\n[14:39][~] # Text in clipboard: This tool does need access to [OpenAI's API](https://openai.com/pricing). It uses the `gpt-3.5-turbo` model.\n[14:40][~] grammatical --tone \"documentation\" -i \"markdown\" -o \"markdown\"\nModified Text:\n This tool requires access to [OpenAI's API](https://openai.com/pricing), utilizing the `gpt-3.5-turbo` model.\nText copied to clipboard.\n[14:40][~]\n```\n\n# My MacOS Workflow\n\nFor my macOS workflow, I have [created a new `Application` in Automator](https://apple.stackexchange.com/questions/419767/how-to-create-a-shortcut-for-a-command-in-terminal-that-i-can-have-in-my-dock) that runs \"Grammatical\" for\nconvenience. I have also dragged it to the Dock.\n\nHere is the AppleScript that I am using:\n\n```applescript\ntell application \"Terminal\"\n    activate\n    do script \"grammatical\"\nend tell\n```\n\nIf you are mostly concerned with the defaults, I highly recommend doing this.\n\n# License\n\nUnder [MIT License](https://github.com/pncnmnp/grammatical/blob/master/LICENSE). The logo is [made using Midjourney](https://docs.midjourney.com/docs/terms-of-service) and licensed under [CC BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpncnmnp%2Fgrammatical","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpncnmnp%2Fgrammatical","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpncnmnp%2Fgrammatical/lists"}