https://github.com/ecornell/ai-tools-ahk
AI Tools - AutoHotkey - Enable global hotkeys to run custom OpenAI prompts on text in any window.
https://github.com/ecornell/ai-tools-ahk
ai autohotkey autohotkey-v2 azure-openai azure-openai-api chatgpt gpt gpt-3 gpt-35-turbo gpt-4 gpt4 gpt4o openai script spicy-autocomplete windows writing
Last synced: 7 months ago
JSON representation
AI Tools - AutoHotkey - Enable global hotkeys to run custom OpenAI prompts on text in any window.
- Host: GitHub
- URL: https://github.com/ecornell/ai-tools-ahk
- Owner: ecornell
- License: mit
- Created: 2023-03-10T02:28:05.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-11-14T20:04:58.000Z (7 months ago)
- Last Synced: 2025-11-14T22:08:22.207Z (7 months ago)
- Topics: ai, autohotkey, autohotkey-v2, azure-openai, azure-openai-api, chatgpt, gpt, gpt-3, gpt-35-turbo, gpt-4, gpt4, gpt4o, openai, script, spicy-autocomplete, windows, writing
- Language: AutoHotkey
- Homepage:
- Size: 379 KB
- Stars: 82
- Watchers: 5
- Forks: 12
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# AI-Tools-AHK
### Table of Contents
- [What's this?](#whats-this)
- [Installation](#installation)
- [Usage](#usage)
- [Options](#options)
- [Credits](#credits)
## What's this?
This is a Windows tool that enables running custom AI prompts on text in any window using global hotkeys.
i.e. Low-friction AI text editing ("spicy autocomplete") anywhere in Windows.
**Where can it be used?**
Almost anywhere in Windows where you can enter text.
## Installation
To get started, first download and extract the [latest release](https://github.com/ecornell/ai-tools-ahk/releases) .zip file. If you already have [AutoHotkey](https://www.autohotkey.com) installed, simply run `AI-Tools.ahk`. If not, use the .exe version, which allows you to use the script without having AutoHotkey installed. The script doesn't install anything and is portable, so you can run it from any location.
When you run the script for the first time, it will create a new `settings.ini` file in the same directory. This file contains the script's settings, which you can edit to change the hotkeys or add your own prompts.
Additionally, the script will prompt you to enter your API key. You can obtain an API key from:
- **OpenAI**: [https://platform.openai.com/](https://platform.openai.com/)
- **Google Gemini**: [https://aistudio.google.com/app/apikey](https://aistudio.google.com/app/apikey)
## Usage
The default hotkeys and prompts are set to the following:
`Ctrl+Shift+j` - (Auto-select text - Fix spelling) - Auto selects the current line or paragraph and runs the "Fix Spelling" prompt and replaces it with the corrected version.
`Ctrl+Shift+k` - (Auto-select text - Prompt Menu) - Auto selects the current line or paragraph and opens the prompt menu.
`Ctrl+Alt+Shift+k` - (Manual-select text - Prompt Menu) - Opens the prompt menu to pick the prompt to run on the selected text.
## Options
The `settings.ini` file contains the settings for the script. You can edit this file to change the prompts, the API mode and model to use, and individual model settings.
**Start with windows**
To have the script start when windows boots up, select "Start With Windows" from the tray icon.
## Supported API Providers
This tool supports multiple AI API providers:
### OpenAI
- **Endpoint**: `https://api.openai.com/v1/chat/completions`
- **Models**: gpt-4, gpt-4-turbo, gpt-3.5-turbo, etc.
- **API Key**: [https://platform.openai.com/](https://platform.openai.com/)
### Azure OpenAI
- **Endpoint**: `https://[resource].openai.azure.com/openai/deployments/[model]/chat/completions`
- **Models**: Your deployed models
- **Documentation**: [Azure OpenAI Quickstart](https://docs.microsoft.com/en-us/azure/openai/quickstart)
### Google Gemini
- **Endpoint**: `https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent`
- **Models**: gemini-2.5-flash, gemini-2.5-flash-lite, etc.
- **API Key**: [https://aistudio.google.com/app/apikey](https://aistudio.google.com/app/apikey)
- **Documentation**: [Gemini API Docs](https://ai.google.dev/gemini-api/docs)
### Configuration
To switch providers, edit the `default_mode` setting in `settings.ini`:
```ini
[settings]
default_mode = mode_chat_completion ; OpenAI (default)
; default_mode = mode_chat_completion_azure ; Azure OpenAI
; default_mode = mode_gemini ; Google Gemini
```
Individual prompts can override the mode by setting `mode=mode_gemini` in their prompt section.
## Compatibility
Tested on:
* Windows 10 Pro 22H2 64-bit
* Windows 11 Pro 25H2
## Credits
TheArkive (JXON_ahk2, M-ArkDown_ahk2), iseahound (SetSystemCursor), and the AHK community.
- https://github.com/iseahound/SetSystemCursor
- https://github.com/TheArkive/JXON_ahk2
- https://github.com/TheArkive/M-ArkDown_ahk2