bsy-clippy
bsy-clippy is a lightweight Python client for the OpenAI Chat Completions API (and compatible deployments).
It supports both batch (stdin) mode for one-shot prompts and interactive mode for chatting directly in the terminal.
You can also load system prompts from a file to guide the LLM’s behavior.
Features
- Speaks to the OpenAI Chat Completions API or any OpenAI-compatible deployment.
- Loads credentials from
.env(OPENAI_API_KEY) viapython-dotenvwhen the selected profile requires them. - Reads defaults (profile, provider, base URL, model) from
bsy-clippy.yamland falls back to a packaged sample if none is found. - Switch profiles by editing
api.profileor passing--profile(e.g.--profile openai) on the CLI. - Defaults to:
- Provider:
ollama - Base URL:
http://172.20.0.100:11434 - Model:
qwen3:1.7b - Mode:
stream(see--modeto switch) - Bundled system prompt file that can be overridden with
--system-file
- Provider:
- Configurable parameters:
--config/--profile→ select a profile file and profile name-b/--base-url,-i/--ip,-p/--port→ override connection details per run-M/--model,-t/--temperature,-m/--mode→ tuning controls-s/--system-file,-u/--user-prompt→ additional prompting knobs-r/--memory-lines,-c/--chat-after-stdin→ conversation persistence options (interactive mode remembers 12 entries by default)
- Two modes of operation:
- Batch mode → waits until the answer is complete, then prints only the final result.
- Stream mode (default) → shows response in real-time, tokens appear as they are generated.
- Colored terminal output:
- Yellow = streaming tokens (the model’s “thinking” in progress).
- Default terminal color = final assembled answer.
Installation
pipx (recommended)
pipx install .
After updating the source, reinstall with pipx reinstall bsy-clippy.
pip / virtual environments
pip install .
Configuration
API credentials (.env)
Create a .env file next to where you run bsy-clippy and add your key:
OPENAI_API_KEY=sk-...
The CLI loads this automatically via python-dotenv; environment variables from your shell work too. Only the openai profile requires this token — ollama profiles can leave it unset.
YAML defaults (bsy-clippy.yaml)
bsy-clippy.yaml selects which profile to use and what settings belong to it. The CLI looks for this file in the current working directory, then in ~/.config/bsy-clippy/, and finally falls back to the bundled sample. Copy the sample to your project or config directory, edit it, and switch profiles as needed:
api:
profile: ollama
profiles:
ollama:
provider: ollama
base_url: http://172.20.0.100:11434
model: qwen3:1.7b
# openai:
# provider: openai
# base_url: https://api.openai.com/v1
# model: gpt-4o-mini
# api_key_env: OPENAI_API_KEY
cesnet:
provider: openai
base_url: https://chat.ai.e-infra.cz/api
#model: glm-5.3
model: mini
api_key_env: CESNET_API_KEY
Switching profiles
- Keep
profile: ollama(the default) to talk to an Ollama server; no API token is required. Adjustbase_urlif your host or port differs. - To use OpenAI, either set
profile: openaiin the file or pass--profile openaion the command line. Make sure theOPENAI_API_KEYenvironment variable (or the name set inapi_key_env) is populated before running the command. - For CESNET/e-INFRA CZ, set
CESNET_API_KEYand select--profile cesnet. The CLI maps the configuredhttps://chat.ai.e-infra.cz/apiURL to the current API endpoint,https://llm.ai.e-infra.cz/v1. - You can define additional profiles (for example, staging clusters) under
api.profilesand select them with--profile <name>.
Quick check
pip install -r requirements.txt # or pipx install .
cp src/bsy_clippy/data/bsy-clippy.yaml ./bsy-clippy.yaml
python bsy-clippy.py --help # confirms dependencies are in place
After copying the sample config you can edit it in-place and re-run bsy-clippy to target a different profile.
If you installed via pipx or pip, copy the bundled sample with:
python -c "import importlib.resources as r, pathlib; pathlib.Path('bsy-clippy.yaml').write_text(r.files('bsy_clippy').joinpath('data/bsy-clippy.yaml').read_text())"
Usage
System prompt file
By default, bsy-clippy loads a bundled prompt (Be very brief. Be very short.).
You can change this with --system-file or disable it via --no-default-system. The CLI always adds its tool instructions so models know when and how to request a local command.
Example bsy-clippy.txt:
You are a helpful assistant specialized in cybersecurity.
Always explain your reasoning clearly, and avoid unnecessary markdown formatting.
These lines will be sent to the LLM before every user prompt.
User prompt parameter
Use --user-prompt "Classify the following log:" when piping data so the model receives:
system prompt (if any)
user prompt text
data from stdin or interactive input
Interactive memory
Interactive mode remembers the last 12 conversation entries (user, assistant, and tool results) by default. Use --memory-lines 6 (or -r 6) to keep six, or -r 0 to disable memory. Only the final assistant reply and tool results are stored; thinking traces are not.
Local command tool
When a request needs information from this machine, the model can request a command. The CLI displays it and asks Execute command? [y/N]: before running it. The command output is sent back to the model so it can answer in the same turn. A declined or blocked command is reported back as well. Up to three commands can run in one turn. Piped input without an interactive terminal cannot approve commands.
Chat after stdin
Use -c / --chat-after-stdin to process piped data first and then remain in interactive mode with the response (and any configured memory) available:
cat sample.txt | bsy-clippy -u "Summarize this report" -r 6 -c
After the initial answer prints, you can continue the conversation while the tool remembers the piped data and the model’s reply.
Interactive mode (default = stream)
Run without piping input:
bsy-clippy
Streaming session looks like:
You: Hello!
LLM (thinking): <think>
Reasoning step by step...
</think>
Hello! How can I assist you today? 😊
Prefer a single print at the end? Switch to batch mode:
bsy-clippy --mode batch
Batch output:
You: Hello!
Hello! How can I assist you today? 😊
Batch mode (stdin)
Pipe input directly:
echo "Tell me a joke" | bsy-clippy
Output:
Why don’t scientists trust atoms? Because they make up everything!
Forcing modes
bsy-clippy --mode batch
bsy-clippy --mode stream
Adjusting temperature
bsy-clippy --temperature 0.2
bsy-clippy --temperature 1.2
Custom server and model
bsy-clippy --profile ollama --base-url http://127.0.0.1:11434 --model llama2
Requirements
See requirements.txt.
Metadata
Release files for bsy-clippy 0.3.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| bsy_clippy-0.3.4.tar.gz | 27.1 kB | Without provenance | Details for bsy_clippy-0.3.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| bsy_clippy-0.3.4-py3-none-any.whl | Python 3 | none | any | Details for bsy_clippy-0.3.4-py3-none-any.whl |
Total release size: 51.0 kB
Release files / bsy_clippy-0.3.4.tar.gz
| Download URL | bsy_clippy-0.3.4.tar.gz |
|---|---|
| Size | 27.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e8cc2875a08e977975ae6447cdd2941c9b44cdc5377528fb71691c32d51cf755
|
|
BLAKE2b-256 checksum How to use checksums |
d3df9cac383fc3c904a6c728854b4d404ad966104749746fe009139736dfb392
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / bsy_clippy-0.3.4-py3-none-any.whl
| Download URL | bsy_clippy-0.3.4-py3-none-any.whl |
|---|---|
| Size | 23.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3a126dd848b2d5f3cdbe7661056a2dd21f17e65425be983278d0f1e2aa19df12
|
|
BLAKE2b-256 checksum How to use checksums |
570b35e2cb473f146ba70600b3b38fa8cf053a478abc9da3ed0e09fe2229b940
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Security for bsy-clippy 0.3.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.