shell-pilot
A shell script for interacting with multiple LLM providers and enhancing intelligent system management.
GraphCanon updated 2w · GitHub synced 2w
Decision brief
Shell-Pilot is a dependency-free shell script for interacting with multiple LLM APIs, offering easy integration into terminal workflows without extra software.
Good fit when
- - When needing a lightweight tool for shell-based interaction with various LLM APIs including OpenAI, Ollama, Mistral AI, LocalAI, and ZhipuAI
- - For users preferring pure shell scripts over complex setup procedures to manage AI models from the terminal
Avoid when
- - Avoid if you require a more feature-rich GUI interface for managing LLM interactions
- - Not recommended if your environment has strict dependency requirements that conflict with lightweight, standalone tools like Shell-Pilot
Observed Jul 12, 2026 · Source: enrich:decision_facts
Verify the decision
Maintenance and security
Full trust report- Maintenance
- Dormant (556d since push)
- As of 2w
- Provenance
- Not a fork · Personal account
- As of 2w
- Security (OSV)
- No lockfile
- As of 1mo
Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.
Install
git clone https://github.com/reid41/shell-pilotSimilar tools
Same-category neighbours. No typed graph edges are catalogued for this tool yet.
Evidence and technical details
Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.
Overview
Shell-pilot is a lightweight, dependency-free shell script that enables terminal interactions with various language model APIs including OpenAI, Ollama, Mistral AI, LocalAI, ZhipuAI. It simplifies the setup of environments and provides a CLI interface for managing these systems intelligently.
Capability facts
- Languages
- shell
Source: github.language · Aug 7, 2026
Categories
Compatibility
Sourced claims from the README excerpt - not unsourced marketing copy.
Source: README excerpt (regex_v1, Aug 7, 2026)
- To install, run this in your terminal and provide your OpenAI API key when asked.Source link
Tags
README
Installation
- For setup
Ollamaenvironment, Manual install instructions, ollama usage, and Ollama model library
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama2 # used llama2 by default
- For setup
LocalAIenvironment, Manual, and LocalAI github
docker run -p 8080:8080 --name local-ai -ti localai/localai:latest-aio-cpu
# Do you have a Nvidia GPUs? Use this instead
# CUDA 11
# docker run -p 8080:8080 --gpus all --name local-ai -ti localai/localai:latest-aio-gpu-nvidia-cuda-11
# CUDA 12
# docker run -p 8080:8080 --gpus all --name local-ai -ti localai/localai:latest-aio-gpu-nvidia-cuda-12
- To install, run this in your terminal and provide your OpenAI API key when asked.
curl -sS -o spilot_install.sh https://raw.githubusercontent.com/reid41/shell-pilot/main/spilot_install.sh
bash spilot_install.sh
- Set your local
Ollamaserver ip in configuration filespilot_common.shif not set during the installation
OLLAMA_SERVER_IP=<ollama server ip address>
- You can also set the other parameters in
spilot_common.shbefore using.
e.g.
TEMPERATURE=0.6
MAX_TOKENS=4096
MODEL_OPENAI=gpt-3.5-turbo
MODEL_OLLAMA=llama2
CONTEXT=false
MULTI_LINE_PROMPT=false
ENABLE_DANGER_FLAG=false
Manual Installation
If you want to install it manually, all you have to do is:
- Download the shell-pilot project files in
git clone https://github.com/reid41/shell-pilot.git
cd shell-pilot/
- If you want to reset
the script path(/usr/local/bin/ by default)oroutput store path(~/spilot_files_dir by default), try below:
# define the config dir if need to reset
new_config_path="/new/path/to/config/"
# define the tmp or output files dir
new_files_dir="/new/path/to/files/"
# create it if new
[[ ! -d ${new_config_path} ]] && mkdir ${new_config_path} -p
[[ ! -d "${new_config_path}/plugins" ]] && mkdir ${new_config_path}/plugins -p
[[ ! -d ${new_files_dir} ]] && mkdir ${new_files_dir} -p
# reset it
sed -i "s|SHELL_PILOT_CONFIG_PATH=\"/usr/local/bin/\"|SHELL_PILOT_CONFIG_PATH=\"$new_config_path\"|" s-pilot
sed -i "s|SPILOT_FILES_DEFAULT_DIR=~/spilot_files_dir|SPILOT_FILES_DEFAULT_DIR=$new_files_dir|" spilot_common.sh
# add ollama server host
ollama_server_ip_address=<ip>
echo "OLLAMA_SERVER_IP=${ollama_server_ip_address}" >> spilot_common.sh
# add localai server host
localai_server_ip_address=<ip>
echo "LOCALAI_SERVER_IP=${localai_server_ip_address}" >> spilot_common.sh
- set the permissions
chmod +x s-pilot spilot_common.sh spilot_llm_rq_apis.sh plugins/*.sh
- Move the files to the dir
cp s-pilot spilot_common.sh spilot_llm_rq_apis.sh ${new_config_path}
cp plugins/*.sh ${new_config_path}/plugins
- Add settings into the profile file
# profile, e.g. .bash_profile
the_profile_file=$HOME/.bash_profile
# add the script/config path
echo "export PATH\=\$PATH\:${new_config_path}" >> $the_profile_file
# add source alias for alias option
echo "alias ss-pilot='source s-pilot'" >> $the_profile_file
# openai/mistral key if need
# openai
openai_api_key_value=<key>
echo "export OPENAI_KEY=${openai_api_key_value}" >> $the_profile_file
# mistral ai
mistralai_api_key_value=<key>
echo "export MISTRAL_API_KEY=${mistralai_api_key_value}" >> $the_profile_file
# zhipuai ai
zhipuai_api_key_value=<key>
echo "export ZHIPUAI_API_KEY=${zhipuai_api_key_value}" >> $the_profile_file
# anthropic ai
anthropic_api_key_value=<key>
echo "export ANTHROPIC_API_KEY=${anthropic_api_key_value}" >> $the_profile_file
# moonshot ai
moonsho
For agents
This page has a .md twin and JSON over the API.