{"id":25121361,"url":"https://github.com/nalgeon/vscode-proofread","last_synced_at":"2025-08-01T00:04:10.203Z","repository":{"id":270482980,"uuid":"910499902","full_name":"nalgeon/vscode-proofread","owner":"nalgeon","description":"Proofread and translate text in VS Code","archived":false,"fork":false,"pushed_at":"2025-01-06T10:37:51.000Z","size":28,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-19T17:38:32.897Z","etag":null,"topics":["grammar","proofread","spelling","translate","vscode-extension","writing"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/nalgeon.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-12-31T12:53:51.000Z","updated_at":"2025-04-12T07:07:32.000Z","dependencies_parsed_at":"2024-12-31T14:49:47.411Z","dependency_job_id":null,"html_url":"https://github.com/nalgeon/vscode-proofread","commit_stats":null,"previous_names":["nalgeon/vscode-proofread"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalgeon%2Fvscode-proofread","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalgeon%2Fvscode-proofread/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalgeon%2Fvscode-proofread/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nalgeon%2Fvscode-proofread/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nalgeon","download_url":"https://codeload.github.com/nalgeon/vscode-proofread/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250337928,"owners_count":21414102,"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":["grammar","proofread","spelling","translate","vscode-extension","writing"],"created_at":"2025-02-08T06:17:57.933Z","updated_at":"2025-04-22T22:49:20.082Z","avatar_url":"https://github.com/nalgeon.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Proofread and translate text in VS Code\n\nThis extension offers _Proofread text_ and _Translate text_ commands in VS Code. It's a simple alternative to DeepL, Grammarly, and other similar tools.\n\nNotable features:\n\n-   Uses Copilot, Ollama, or OpenAI for proofreading.\n-   Configurable language model and prompts (with good defaults).\n-   Supports many target languages (default is English).\n\n⚠️ By default, this extension uses the Copilot API. It's free with a limit of 50 requests per month, or unlimited for paid Copilot subscribers. Unfortunately, Copilot only supports proofreading, not translation. To use the extension for translation, switch to Ollama or OpenAI (see details below).\n\n## Installation\n\nOpen the VS Code marketplace (`Ctrl+Shift+X` / `Cmd+Shift+X`), search for the extension by typing \"proofread\" or \"nalgeon.proofread\", and click _Install_. You're all set!\n\n## Commands\n\nRun these commands from the VS Code command palette (`Ctrl+Shift+P` / `Cmd+Shift+P`).\n\n**Proofread: Proofread Text**\n\nProofreads the selected text and prints the suggested changes below it.\n\n**Proofread: Translate Text**\n\nTranslates the selected text and overwrites it with the translation. Only available if `proofread.ai.vendor` set to `openai`.\n\n**Proofread: Set OpenAI API Key**\n\nSets the value of the OpenAI API key. Only required if `proofread.ai.vendor` set to `openai`.\n\n## Using Ollama\n\nOllama runs AI models locally on your machine. Here's how to set it up:\n\n1. Download and install [Ollama](https://ollama.com/) for your operating system.\n2. Set the [environment variables](https://github.com/ollama/ollama/blob/main/docs/faq.md#how-do-i-configure-ollama-server) to use less memory:\n\n```\nOLLAMA_KEEP_ALIVE = 1h\nOLLAMA_FLASH_ATTENTION = 1\n```\n\n3. Restart Ollama.\n4. Download the AI model Gemma 2:\n\n```\nollama pull gemma2:2b\n```\n\n5. Change the Proofread settings:\n\n```\nproofread.ai.vendor = ollama\nproofread.ai.model = gemma2:2b\n```\n\nThat's it!\n\nGemma 2 is a lightweight model that uses about 1GB of memory and works quickly without a GPU. For good results, send only a few paragraphs at a time for proofreading or translation.\n\nFor larger documents or improved results, try models like `mistral` or `mistral-nemo`.\n\n## Using OpenAI\n\nOpenAI offers state-of-the-art AI models through an API. Here's how to switch to it:\n\n1. Get an API key from the [OpenAI Settings](https://platform.openai.com/account/api-keys).\n2. When you have the key, set it using the _Proofread: Set OpenAI API Key_ command.\n3. Change the Proofread setting `proofread.ai.vendor` to `openai`.\n\nThat's it!\n\n⚠️ OpenAI is a **paid service**; they charge for API use.\n\n## Settings\n\n`proofread.ai.vendor`\n\nName of the AI model provider. Must be either `copilot`, `ollama`, or `openai`. Default: `copilot`\n\n`proofread.ai.url`\n\nCustom URL of the AI API endpoint (leave empty to use the default URL).\n\n`proofread.ai.model`\n\nName of the AI model to use. Default: `gpt-4o`\n\n`proofread.ai.temperature`\n\nSampling temperature to use (between 0 and 2). Higher values make the output more random, while lower values make it more focused and predictable. Default: `0`\n\n`proofread.ai.timeout`\n\nTimeout for AI API requests in seconds. Default: `30`\n\n`proofread.language`\n\nThe language to proofread or translate the text into. Default: `English (US)`\n\n`proofread.prompt.proofread`\n\nThe prompt to send to the OpenAI API for proofreading.\n\n`proofread.prompt.translate`\n\nThe prompt to send to the OpenAI API for translation.\n\n## License\n\nCreated by [Anton Zhiyanov](https://antonz.org/). Released under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnalgeon%2Fvscode-proofread","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnalgeon%2Fvscode-proofread","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnalgeon%2Fvscode-proofread/lists"}