theJayTea / WritingTools

A better version of Apple Intelligence Writing Tools, for Windows ā€” the world's smartest system-wide grammar assistant. Works with the free Gemini API, local LLMs, and other cloud providers.
GNU General Public License v3.0
311 stars 15 forks source link
ai artificial-intelligence gemini grammar-checker largelanguagemodel llm writing-tool

Writing Tools

https://github.com/user-attachments/assets/d3ce4694-b593-45ff-ae9a-892ce94b1dc8

šŸš€ What is Writing Tools?

Writing Tools is an Apple Intelligence-inspired application for Windows that supercharges your writing with AI LLMs. It lets you fix up grammar and more with one hotkey press, system-wide. It's currently the world's most intelligent system-wide grammar assistant.

šŸŒŸ Why Choose Writing Tools?

Aside from being the only Windows program that works like Apple's Writing Tools:

Writing Tools has been featured on Beebom, XDA, and more!

āœØ Features

Invoke Writing Tools with no text selected to enter a chat mode.

šŸ–± How to Use

  1. Select any text in any application (or don't select any text to use chat mode).
  2. Press your hotkey (default: Ctrl+Space).
  3. Choose an option from the popup menu or enter a custom instruction.
  4. Watch as your text is magically improved!

šŸ›  Installation

  1. Go to the Releases page and download the latest Writing.Tools.zip file.

  2. Extract it where you want, run Writing Tools.exe, and enjoy! :D

    Note: If you extract Writing Tools into a protected system folder like Program Files, you'll need to run it as administrator at least on the first launch or it won't be able to create/edit its config file (in the same folder as its exe).

  3. To let it automatically start when you boot your PC, add a shortcut of the Writing Tools.exe to the Windows Start-Up folder (Open Run and type shell:startup to get to this folder).

šŸ¦™ (optional) Ollama Local LLM Instructions:

  1. Download and install Ollama.
  2. Choose the LLM you want to use form here. Recommended: Llama 3.1 8B if you have ~8GB of RAM or VRAM.
  3. Open your terminal, and type ollama run llama3.1:8b. This will download and run Llama 3.1. That's it! Leave this running in the background.
  4. In Writing Tools, choose the OpenAl Compatible AI Provider, and set your API Key to ollama, your API Base URL to http://localhost:11434/v1, and your API Model to llama3.1:8b. Enjoy Writing Tools with absolute privacy and no internet connection! šŸŽ‰

šŸ”’ Privacy

I believe strongly in protecting your privacy. Writing Tools:

Note: Privacy policies may vary depending on the AI provider you choose. Please review the terms of service for your selected provider.

šŸž Known Issues

  1. On some devices, Writing Tools does not work correctly with the default hotkey. To fix it, simply change the hotkey to ctrl+` or ctrl+j and restart Writing Tools. PS: If a hotkey is already in use by a program or background process, Writing Tools may not be able to intercept it. The above hotkeys are usualy unused.

  2. The initial launch of the Writing Tools.exe might take unusually long ā€” this seems to be because AV software extensively scans this new executable before letting it run. Once it launches into the background in RAM, it works instantly as usual.

šŸ‘Øā€šŸ’» To run Writing Tools directly from the code

If you prefer to run it directly from the main.py file:

  1. Download the code by clicking this button above: image

  2. Right-click the folder of the code you downloaded, and click Open in Terminal. You'll only have to do this once: Type pip install -r requirements.txt. Of course, you'll need to have Python installed!.

  3. Any time you want to run the program, just type python main.py in your terminal.

šŸ‘Øā€šŸ’» To compile the application yourself:

Here's how to compile it with PyInstaller:

  1. Install PyInstaller: pip install pyinstaller
  2. Run the build script: pyinstaller-build-script.py

Ideally, run this in a Python venv.

šŸŒŸ Contributors

Writing Tools would not be where it is today without its amazing contributors:

  1. Cameron Redmore (CameronRedmore): Extensively refactored Writing Tools and added OpenAI Compatible API support, streamed responses, and the chat mode when no text is selected.

  2. Disneyhockey40 (Soszust40): Helped add dark mode, the plain theme, tray menu fixes, and UI improvements.

šŸ¤ Contributing

I welcome contributions! :D If you'd like to improve Writing Tools, feel free to open a Pull Request or get in touch with me.

šŸ“¬ Contact

My email: jesaitarun@gmail.com

Made with ā¤ļø by a high school student. Check out my other AI app, Bliss AI, a novel AI tutor free on the Google Play Store!

šŸ“„ License

Distributed under the GNU General Public License v3.0.