https://github.com/bgeneto/espanso-llm-ask-ai
An Espanso package that enables users to quickly send prompts to a local (e.g. Ollama or LM Studio) or remote LLM API calls (OpenAI standard) and insert the AI-generated response directly into any text field.
https://github.com/bgeneto/espanso-llm-ask-ai
Last synced: 10 months ago
JSON representation
An Espanso package that enables users to quickly send prompts to a local (e.g. Ollama or LM Studio) or remote LLM API calls (OpenAI standard) and insert the AI-generated response directly into any text field.
- Host: GitHub
- URL: https://github.com/bgeneto/espanso-llm-ask-ai
- Owner: bgeneto
- Created: 2025-06-13T15:23:54.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-13T15:28:57.000Z (about 1 year ago)
- Last Synced: 2025-06-13T16:46:25.305Z (about 1 year ago)
- Language: Python
- Size: 6.84 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# espanso-llm-ask-ai
An Espanso package that enables users to quickly send prompts to a local (e.g. Ollama or LM Studio) or remote LLM API calls (OpenAI standard) and insert the AI-generated response directly into any text field.
## Requirements
- [Espanso](https://espanso.org/) installed and running
- Python 3.9+ installed and available on your system path
- Required Python packages: `openai` and `python-dotenv` (see `requirements.txt`)
- Access to a local LLM (such as [Ollama](https://ollama.com/) or [LM Studio](https://lmstudio.ai/)) or a remote OpenAI compatible API (in this case, you will need to provide your API key in the `.env` file)
## Configuration
Edit the `.env` environment file inside the package directory () to set the `API_KEY`, `BASE_URL`and `MODEL`. Example:
```bash
API_KEY=ollama
BASE_URL=http://localhost:11434/v1
MODEL=llama3.2
```
> NOTE: don't forget to pull the Ollama model first. In the case above, just issue the command:
>
> `ollama pull llama3.2`
## Usage
- Type the Espanso trigger for this package (`:ask:ai`) in any text field.
- Enter your desired AI prompt when asked.
- The AI-generated response will be inserted automatically (this can take several seconds, so choose a small and low latency LLM model).
### Example
Type:
```
:ask:ai
```
Then enter:
```
Summarize the following text: ...
```
Press the "Submit" button or "CTRL + Enter" to send the request. The response from your configured LLM will appear in place.
## Troubleshooting
- Make sure Python is available globally on your system's PATH environment variable and that the required packages are installed.
- Check that your BASE_URL endpoint, MODEL and API_KEY are correctly set in the `.env` file (located in the Espanso config directory: `%CONFIG%/match/packages/espanso-llm-ask-ai/.env`).
- After sending the request, make sure the cursor doesn’t lose focus and remains blinking at the correct insertion point. If it doesn’t, just click to place it right after the trigger string like this **:ask:ai|**
- Review Espanso logs for errors.
## License
MIT
## Author
Bernhard Enders
## Links
- [Homepage](https://github.com/bgeneto/espanso-llm-ask-ai)
- [Espanso Documentation](https://espanso.org/docs/)