Skip to main content

Fetch definitions and example sentences for words directly from your terminal

Project description

sollu

Your Terminal Dictionary powered by AI

License PyPI version

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:

  1. Python 3.9+: Make sure you have a compatible Python version installed.
  2. 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

Single word

Defining multiple words:

sollu define stoic healthy

Multiple words

License

This project is licensed under the Apache-2.0 License - see the LICENSE file for details

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sollu-0.0.2.tar.gz (11.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sollu-0.0.2-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

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

Hashes for sollu-0.0.2.tar.gz
Algorithm Hash digest
SHA256 695adf144680bf923744a37fb951093369508d612f5d60b1304cf3b7da861172
MD5 68cc215a74aee9106c9eb6de62ecf678
BLAKE2b-256 6179fe6a0c97c2a5759c2826e7fe812cf50f790ba8d53f5595419a862cb0c562

See more details on using hashes here.

Provenance

The following attestation bundles were made for sollu-0.0.2.tar.gz:

Publisher: publish_pypi.yml on ash-01xor/sollu

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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

Hashes for sollu-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4e23d171cc0fb5f7c6c23ecf32ef8efede31fae0a4d1f41a4acd9e2b8cbf5265
MD5 6865cedce7056e1bc5db2787850f0b60
BLAKE2b-256 195530088af6eac50069908e297c4dedff3b0fac738ebe8d399a21682af5dace

See more details on using hashes here.

Provenance

The following attestation bundles were made for sollu-0.0.2-py3-none-any.whl:

Publisher: publish_pypi.yml on ash-01xor/sollu

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page