A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://github.com/djcopley/ShellOracle below:

djcopley/ShellOracle: A terminal utility for intelligent shell command generation

ShellOracle is an innovative terminal utility designed for intelligent shell command generation, bringing a new level of efficiency to your command-line interactions. ShellOracle currently supports Ollama, OpenAI, Deepseek, LocalAI, and Grok!

Show your support for ShellOracle and keep an eye out for exciting new developments by clicking the ⭐ and a 👀!

Key features of ShellOracle include:

Installing ShellOracle is easy!

  1. pipx install the shelloracle package
  2. Configure ShellOracle and follow the prompts
  3. Refer to the providers section for specific details regarding your chosen provider.

Upgrading to the latest version of ShellOracle is just as simple!

  1. pipx upgrade the shelloracle package

Installation with pip is supported, however, pipx is preferred for its automatic environment isolation.

ShellOracle is designed to be used as a BASH/ZSH/fish widget activated by the CTRL+F keyboard shortcut.

  1. Press CTRL+F
  2. Describe your command
  3. Press Enter

The generated command will be inserted into your shell prompt after a brief processing period.

Other ways to run ShellOracle

ShellOracle can be run as a Python module with python3 -m shelloracle or using its entrypoint shor, however, running ShellOracle with this method will not automatically insert the result into your shell prompt.

  1. If you press CTRL+F with text in your ZLE buffer, all text left of your cursor will carry over to your ShellOracle prompt.
  2. ⬆️ arrow and ⬇️ arrow cycle through your prompt history.
  3. ShellOracle can be chained with other commands; try: echo "find all the python files in my cwd" | shor

Before using ShellOracle with Ollama, pull the model you chose in the configure step. For example, if you chose dolphin-mistral, run:

ollama pull dolphin-mistral

Refer to the Ollama docs for installation, available models, and usage.

To use ShellOracle with OpenAI's models, create an API key. Edit your ~/.shelloracle/config.toml to change your provider and enter your API key. You can use shor config edit as a shorthand to edit this file.

To use ShellOracle with Deepseek's models, create an API key. Edit your ~/.shelloracle/config.toml to change your provider and enter your API key. You can use shor config edit as a shorthand to edit this file.

Refer to the LocalAI docs for installation, available models, and usage.

To use ShellOracle with XAI's models, create an API key. Edit your ~/.shelloracle/config.toml to change your provider and enter your API key. You can use shor config edit as a shorthand to edit this file.

To use ShellOracle with Google's models, create an API key. Edit your ~/.shelloracle/config.toml to change your provider and enter your API key. You can use shor config edit as a shorthand to edit this file.

ShellOracle's configuration is your gateway to tailoring the utility to match your preferences and requirements. The ~/.shelloracle/config.toml file serves as the control center for customizing various aspects of ShellOracle's behavior. You can quickly access and edit this file using the command shor config edit.

ShellOracle supports BASH, ZSH and fish on macOS and Linux.

For cloud providers like OpenAI, there are no hardware requirements.

If running locally, refer to your model for hardware requirements.

Encountered problems? File an issue. Feature requests are welcome, and contributions can be made by opening a pull request.

This software is licensed under the GPLv3 license.

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4