KO
|
EN
gitlite — search
Search
#python
#react
#machine-learning
#javascript
#deep-learning
#css
#html
#flutter
#docker
#data-science
#api
#pytorch
AI-Snip
★ 47
Open GitHub ↗
Bring clippy back to windows
Download README (.md)
Explore Similar Repositories
imphnen-certificate
:
No description available.
carbon-ai-chat
:
Carbon AI chat is a front-end chat framework from the IBM Carbon team.
go-extend
:
go-extend
mesh-transition-material
:
A custom threejs material that creates a transition effect on color change
hotwire-native-demo
:
Demo web server for the Hotwire Native frameworks
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
AI-Snip
?
Download (.md)
# Bring clippy back to windows (As an AI snip tool) https://github.com/user-attachments/assets/b3ebcbc1-7010-4f44-bdaa-0c7998e655f6 ## Installation ### Windows installation The most easy way to run AI-Snip is by downloading the binary from the releases page and running it. If you are python-savvy, you may instead: 1. Clone this repo 2. `pip install pyqt6 pyperclip keyboard openai` 3. `python aisnip.py` from the root of this repo ### Linux installation There is no uniform system tray in Linux. So in Linux you will only be able to do one snip each time you run this program. There are no binaries provided for Linux. * Tested with python 3.11, but other versions should work. * For pyqt6 you will need libxcb-cursor0. So on Ubuntu, run `sudo apt install libxcb-cursor0`. * `pip install pyqt6 pyperclip openai`. * `python aisnip.py` when you are ready to go snipping. ### Choosing your backend You'll need an LLM backend to run AI-Snip. Currently available options are 1. OpenAI with an api key 2. Ollama running locally ### Adding your API key for OpenAI If you choose OpenAI as your backend, you will need an *OpenAI* or *AzureOpenAI* API key to run AI-Snip There are two methods to add you api key. 1. The simplest way to add your keys is to start the program and enter your OpenAI API key in the popup window. This will create an openai_api_key.txt file in your folder to remember the key for the next startup. 2. A somewhat more clean way is to add your key to the environment variables. If *OPENAI_API_KEY* or *AZURE_OPENAI_API_KEY* is set, then aisnip will use them automatically. ### Running with Ollama Follow the [ollama](https://github.com/ollama/ollama) site to get your ollama server up and running. Install ollama for python `pip install ollama` Then, copy the contents of `config.yml.ollama` into a file named `config.yml` saved in the same folder as your `aisnip.exe` binary or `aisnip.py` depending on if you run with the binary or the python interpreter. Change the model_name and ollama_host depending on your setup/likings. ## Usage When you start AI-Snip, it will minize itself to the system tray. To start snipping, you can a) Left click on clippy in the system tray b) Press `CTRL+SHIFT+A` During snipping, you are by default in explaination mode. When you snip a region, clippy will pop up after a few seconds and explain whatever you snipped. There are various hotkeys available while snipping: * **D**: Toggles clippy (always starts on) * **C**: Toggles if AI response is copied to clipboard (always starts off). This will also disable streaming, resulting in slower response times. * **E**: Go into translation into english mode. Will also set clipboard on. * **L**: Go into Latex mode. Toggles clippy off and clipboard on. * **T**: Free prompt mode. Write your own prompt for the AI to answer. * **Q** or **Esc**: Cancel your ongoing snip or close clippy (you may have to re-select the clippy window if you de-selected it). ## Adding to startup If you want to use AI-Snip as an everyday tool, you may want to always have it in your system tray. The easiest way to accomplish this is to donwload the binary, create a Shortcut for it, then go `win + r` and type `shell:startup` and press Enter. Then move your shortcut in the folder that opened.