https://github.com/susiai/susi_shell
This suite of tools enables users to interact with AI services directly from their terminal.
https://github.com/susiai/susi_shell
Last synced: 11 months ago
JSON representation
This suite of tools enables users to interact with AI services directly from their terminal.
- Host: GitHub
- URL: https://github.com/susiai/susi_shell
- Owner: susiai
- License: lgpl-3.0
- Created: 2017-11-25T14:51:30.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2025-02-21T19:35:14.000Z (about 1 year ago)
- Last Synced: 2025-04-03T03:58:13.315Z (11 months ago)
- Language: Python
- Homepage:
- Size: 45.9 KB
- Stars: 1,005
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cli-agents - susiai/susi_shell - This suite of tools enables users to interact with AI services directly from their terminal. [Terminal] (1k⭐) (🚀 AI Tools for Vim, Neovim, and Terminal)
README
# AI Command Line Tools
Welcome to the `susi_shell` repository, which is part of the susi_api project aimed at providing AI capabilities in a command-line based environment. This suite of tools enables users to interact with AI services directly from their terminal.
Some of these tools currently require a working connection to the OpenAI API.
Future versions of this command line tool collection should use local self-hosted services.
We implement those function in the susi_api project.
## Available Commands (all to be implemented)
- `run ` - Run a model with the given name and chat.
- `ask ` - Provides an answer to a submitted question.
- `context` - Select, view or create a context for the ask command.
- `complete` - Takes a piece of text and uses AI to generate a contextually relevant completion.
- `listen` - record audio and optionally pass it to the transscript command
- `transscript` - Listens to audio input and transcribes it into text.
- `translate` - Translates a block of text from one language to another.
- `say` - Converts text to speech. (Note: This command is currently available on macOS. by default)
## Usage
You can use `susi_shell` in one of two ways:
- interactive: run `./susi_shell.sh run ` to use the susi_shell in a similar way as ollama
- batch: run `echo "hello world" | ./susi_shell.sh ask ` to use stdin as input for a prompt to the ``