{"id":30328603,"url":"https://github.com/bgeneto/espanso-llm-ask-ai","last_synced_at":"2025-10-09T06:37:41.490Z","repository":{"id":298921522,"uuid":"1001554353","full_name":"bgeneto/espanso-llm-ask-ai","owner":"bgeneto","description":"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.","archived":false,"fork":false,"pushed_at":"2025-06-13T15:28:57.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-13T16:46:25.305Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bgeneto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-06-13T15:23:54.000Z","updated_at":"2025-06-13T15:29:00.000Z","dependencies_parsed_at":"2025-06-13T16:46:39.895Z","dependency_job_id":"60158c6e-2a3e-4571-aac6-2fdeeaff2b49","html_url":"https://github.com/bgeneto/espanso-llm-ask-ai","commit_stats":null,"previous_names":["bgeneto/espanso-llm-ask-ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bgeneto/espanso-llm-ask-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgeneto%2Fespanso-llm-ask-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgeneto%2Fespanso-llm-ask-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgeneto%2Fespanso-llm-ask-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgeneto%2Fespanso-llm-ask-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bgeneto","download_url":"https://codeload.github.com/bgeneto/espanso-llm-ask-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bgeneto%2Fespanso-llm-ask-ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270929288,"owners_count":24669681,"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","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-08-18T01:10:10.617Z","updated_at":"2025-10-09T06:37:36.455Z","avatar_url":"https://github.com/bgeneto.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# espanso-llm-ask-ai\n\nAn 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.\n\n## Requirements\n\n- [Espanso](https://espanso.org/) installed and running\n- Python 3.9+ installed and available on your system path\n- Required Python packages: `openai` and `python-dotenv` (see `requirements.txt`)\n- 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)\n\n## Configuration\n\nEdit the `.env` environment file inside the package directory () to set the `API_KEY`, `BASE_URL`and `MODEL`. Example:\n\n```bash\nAPI_KEY=ollama\nBASE_URL=http://localhost:11434/v1\nMODEL=llama3.2\n```\n\n\u003e NOTE: don't forget to pull the Ollama model first. In the case above, just issue the command:\n\u003e\n\u003e `ollama pull llama3.2`\n\n## Usage\n\n- Type the Espanso trigger for this package (`:ask:ai`) in any text field.\n- Enter your desired AI prompt when asked.\n- The AI-generated response will be inserted automatically (this can take several seconds, so choose a small and low latency LLM model).\n\n### Example\n\nType:\n```\n:ask:ai\n```\nThen enter:\n```\nSummarize the following text: ...\n```\nPress the \"Submit\" button or \"CTRL + Enter\" to send the request. The response from your configured LLM will appear in place.\n\n## Troubleshooting\n\n- Make sure Python is available globally on your system's PATH environment variable and that the required packages are installed.\n- 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`).\n- 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|**\n- Review Espanso logs for errors.\n\n## License\n\nMIT\n\n## Author\n\nBernhard Enders\n\n## Links\n\n- [Homepage](https://github.com/bgeneto/espanso-llm-ask-ai)\n- [Espanso Documentation](https://espanso.org/docs/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbgeneto%2Fespanso-llm-ask-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbgeneto%2Fespanso-llm-ask-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbgeneto%2Fespanso-llm-ask-ai/lists"}