Fetch definitions and example sentences for words directly from your terminal
Project description
sollu
Your Terminal Dictionary powered by AI
Overview
sollu is a simple yet powerful command-line utility designed to provide instant definitions and example sentences for words using the capabilities of the Google Gemini model. Built for anyone who wants to stay in the flow without distractions, tabs.
Features
- Fast Lookups: Get definitions and examples quickly.
- Multiple Words: Define several words in a single command.
Prerequisites
Before you can use Sollu, you need:
- Python 3.9+: Make sure you have a compatible Python version installed.
- Google Gemini API Key: Obtain a free API key from the Google AI Studio
Installation
It's highly recommended to install sollu within a virtual environment.
pip install sollu
Configuration
Sollu requires your Google Gemini API key to function. Configuration commands are grouped under sollu config
Your API key will be stored in a file named .env inside the directory ~/.config/sollu.
Set API key
Use the config set subcommand to save your API key:
sollu config set --key YOUR_API_KEY
Delete API key
To remove just the saved API key:
sollu config delete
Reset configuration
To delete the entire ~/.config/sollu/ directory and all its contents:
sollu config reset
Usage
Once installed and configured, you can use the define command to look up words:
sollu define <word1> <word2> ...
Examples
Defining a single word
sollu define work-ethic
Defining multiple words:
sollu define stoic healthy
License
This project is licensed under the Apache-2.0 License - see the LICENSE file for details
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sollu-0.0.2.tar.gz.
File metadata
- Download URL: sollu-0.0.2.tar.gz
- Upload date:
- Size: 11.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
695adf144680bf923744a37fb951093369508d612f5d60b1304cf3b7da861172
|
|
| MD5 |
68cc215a74aee9106c9eb6de62ecf678
|
|
| BLAKE2b-256 |
6179fe6a0c97c2a5759c2826e7fe812cf50f790ba8d53f5595419a862cb0c562
|
Provenance
The following attestation bundles were made for sollu-0.0.2.tar.gz:
Publisher:
publish_pypi.yml on ash-01xor/sollu
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sollu-0.0.2.tar.gz -
Subject digest:
695adf144680bf923744a37fb951093369508d612f5d60b1304cf3b7da861172 - Sigstore transparency entry: 210445208
- Sigstore integration time:
-
Permalink:
ash-01xor/sollu@b158fad906c07da6c88e5d3ed548c6253f0b6b28 -
Branch / Tag:
refs/tags/v0.0.2 - Owner: https://github.com/ash-01xor
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish_pypi.yml@b158fad906c07da6c88e5d3ed548c6253f0b6b28 -
Trigger Event:
release
-
Statement type:
File details
Details for the file sollu-0.0.2-py3-none-any.whl.
File metadata
- Download URL: sollu-0.0.2-py3-none-any.whl
- Upload date:
- Size: 11.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4e23d171cc0fb5f7c6c23ecf32ef8efede31fae0a4d1f41a4acd9e2b8cbf5265
|
|
| MD5 |
6865cedce7056e1bc5db2787850f0b60
|
|
| BLAKE2b-256 |
195530088af6eac50069908e297c4dedff3b0fac738ebe8d399a21682af5dace
|
Provenance
The following attestation bundles were made for sollu-0.0.2-py3-none-any.whl:
Publisher:
publish_pypi.yml on ash-01xor/sollu
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sollu-0.0.2-py3-none-any.whl -
Subject digest:
4e23d171cc0fb5f7c6c23ecf32ef8efede31fae0a4d1f41a4acd9e2b8cbf5265 - Sigstore transparency entry: 210445216
- Sigstore integration time:
-
Permalink:
ash-01xor/sollu@b158fad906c07da6c88e5d3ed548c6253f0b6b28 -
Branch / Tag:
refs/tags/v0.0.2 - Owner: https://github.com/ash-01xor
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish_pypi.yml@b158fad906c07da6c88e5d3ed548c6253f0b6b28 -
Trigger Event:
release
-
Statement type: