{"id":30386356,"url":"https://github.com/akrem-chabchoub/correctly","last_synced_at":"2025-08-21T03:11:20.204Z","repository":{"id":259608310,"uuid":"879040558","full_name":"akrem-chabchoub/correctly","owner":"akrem-chabchoub","description":"The AI-Powered Keyboard Layout Fixer.  Tired of typing in the wrong keyboard layout? Correctly automatically detects and corrects your typing mistakes using AI","archived":false,"fork":false,"pushed_at":"2024-10-26T21:23:00.000Z","size":13,"stargazers_count":31,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-11T04:47:56.965Z","etag":null,"topics":["ai","correction","keyboard-layout"],"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/akrem-chabchoub.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-10-26T19:54:29.000Z","updated_at":"2025-04-26T23:43:41.000Z","dependencies_parsed_at":"2024-10-26T21:50:13.943Z","dependency_job_id":"980bda51-c7ed-44b7-a79e-4bfde5fa3c9e","html_url":"https://github.com/akrem-chabchoub/correctly","commit_stats":null,"previous_names":["mohamedch7/correctly","akrem-chabchoub/correctly"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/akrem-chabchoub/correctly","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akrem-chabchoub%2Fcorrectly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akrem-chabchoub%2Fcorrectly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akrem-chabchoub%2Fcorrectly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akrem-chabchoub%2Fcorrectly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akrem-chabchoub","download_url":"https://codeload.github.com/akrem-chabchoub/correctly/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akrem-chabchoub%2Fcorrectly/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271420146,"owners_count":24756490,"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","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"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":["ai","correction","keyboard-layout"],"created_at":"2025-08-21T03:11:18.480Z","updated_at":"2025-08-21T03:11:20.196Z","avatar_url":"https://github.com/akrem-chabchoub.png","language":"Python","readme":"# Correctly\n\n**Correctly** is an intelligent typing tool that understands your typing intent, even if you're using the wrong keyboard layout. Forget about switching languages manually—Correctly detects and corrects mistyped input, ensuring your message comes out just as you intended.\n\nhttps://github.com/user-attachments/assets/84d802de-d99e-4667-b545-0ca6784c5ae6\n\n## Features\n\n- **Automatic Keyboard Layout Detection**: Detects if you're using the wrong layout and automatically corrects it.\n- **AI-Powered Correction**: Uses AI to understand the intended text and corrects typing mistakes caused by using the wrong layout.\n- **Supports Multiple Languages**: Correctly works with multiple language layouts, including English and Arabic (or others with customization).\n\n## How It Works\n\nCorrectly listens to your keyboard input, and after a brief delay, analyzes what you typed. Using AI, it detects if the input doesn't match the intended language and corrects it accordingly.\n\nFor example, if you forget that your keyboard layout is set to Arabic and you start typing in English, Correctly will automatically convert “اثممخ صخقمي” to “hello world”.\n\n## Installation\n\n1. Clone this repository:\n   ```sh\n   git clone https://github.com/mohamedch7/correctly.git\n   cd correctly\n   ```\n2. Install the required dependencies:\n   ```sh\n   pip install -r requirements.txt\n   ```\n3. Set up your `.env` file with your OpenAI API key:\n   ```\n   OPENAI_API_KEY=your_openai_api_key_here\n   ```\n\n## Usage\n\nRun the Python script to start listening to your keyboard input:\n\n```sh\npython3 script.py\n```\n\nCorrectly will start running in the background and automatically correct your typing if you use the wrong keyboard layout.\n\n## Configuration\n\n- **Keyboard Layouts**: You can customize the English and Arabic keyboard layouts in the `script.py` file by editing the `ENGLISH_LAYOUT` and `ARABIC_LAYOUT` constants.\n\n## Requirements\n\n- Python 3.7+\n- `pynput` for capturing keyboard input.\n- `openai` for AI-powered correction.\n- `python-dotenv` for loading environment variables.\n\n## Example\n\nIf you mistakenly type `اثممخ صخقمي` while intending to write `hello world`, Correctly will detect the wrong layout and convert it automatically to `hello world`.\n\n## Contributing\n\nContributions are welcome! Feel free to submit issues or pull requests to improve Correctly.\n\n## License\n\nThis project is licensed under the MIT License. See the `LICENSE` file for more details.\n\n## Acknowledgments\n\n- Thanks to OpenAI for providing the powerful language model used to correct mistyped input.\n- Inspired by the challenge of switching between language layouts seamlessly while typing.\n\n## Contact\n\nIf you have any questions or feedback, please reach out at [mohamedakremch@protom.me].\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakrem-chabchoub%2Fcorrectly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakrem-chabchoub%2Fcorrectly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakrem-chabchoub%2Fcorrectly/lists"}