CLI tool for deciphering internet abbreviations using Gemini API
Project description
██████╗ ███████╗ ██████╗██████╗ ██╗ ██╗██████╗ ████████╗
██╔══██╗██╔════╝██╔════╝██╔══██╗╚██╗ ██╔╝██╔══██╗╚══██╔══╝
██║ ██║█████╗ ██║ ██████╔╝ ╚████╔╝ ██████╔╝ ██║
██║ ██║██╔══╝ ██║ ██╔══██╗ ╚██╔╝ ██╔═══╝ ██║
██████╔╝███████╗╚██████╗██║ ██║ ██║ ██║ ██║
╚═════╝ ╚══════╝ ╚═════╝╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝
AI-powered CLI utility providing an operational bridge between natural language instructions, automatic Git commit generation, and contextual slang decoding using the Google Gemini API. Built for high performance and strict output isolation.
Features
- Automated Commit Generation (Default Mode): Automatically extracts and staging-analyses active local diffs via
git diff --stagedto generate professional, clean Conventional Commits messages. - Natural Language Shell Commands (
-s/--shell): Converts loose technical intents into valid, optimized, executable Bash or cross-platform terminal commands. - Accurate Slang & Internet Abbreviation Decoder (
-sl/--slang): Recovers structure, expands short forms, and normalizes text lacking vowels or proper grammar into standard text for specified target languages. - Fault-Tolerant Fallback System: Uses a multi-model architecture pool (
gemini-2.5-flash->gemini-2.5-flash-lite) combined with exponential backoff retries viatenacityto stay operational during 429 quota limits or 503 errors.
Installation
git clone [https://github.com/REvDl/Scripts.git](https://github.com/REvDl/Scripts.git)
cd Scripts/automation_tool/DecrypMessage
pip install .
Configuration
On the initial execution, the application will automatically prompt you to enter your Gemini API Key and preferred default language. These credentials are saved to a local configuration file.
- Storage Location:
~/.config/decrypt/.env - Manual Reset Command:
decrypt --config
Technical Reference & CLI Arguments
usage: decrypt [-h] [--lang LANG] [--config] [-sl] [-s] [-c] [text]
AI-powered CLI tool
• Conventional Commits
• Shell Commands
• Slang Decoder
positional arguments:
text Optional text input. Commit mode (default): if empty, uses git diff;
if provided, generates commit from this description.
options:
-h, --help show this help message and exit
--lang LANG Transcription language (default from .env)
--config Force re-configure API key and language
-sl, --slang Mode: Accurately expand and decipher internet abbreviations and slang
-s, --shell Mode: Generate an executable shell command from natural language
-c, --commit Mode: Generate Git commit message from text or staged diffs (default)
Usage Examples
1. Generating Conventional Commits
Stage your local changes and execute the default command pipeline:
git add src/core.py
decrypt
Alternatively, pass raw text input directly through standard arguments to format a manual draft:
decrypt "fixed a broken connections pooling bug inside the database wrapper"
2. Translating Natural Language to Terminal Syntax
decrypt -s "find all json files in the current folder larger than 50 megabytes and delete them"
3. Expanding Slang / Chat History
decrypt -sl "hru btw" --lang "English"
4. Interactive Mode (REPL)
Executing the engine without positional string parameters drops down into a low-overhead, persistent shell environment running standard loops:
decrypt -s
Interactive mode (SHELL). Language: English. Type 'exit' to quit.
> list all docker containers running on port 80
docker ps --filter "publish=80"
>
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
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 decrypt-1.1.0.tar.gz.
File metadata
- Download URL: decrypt-1.1.0.tar.gz
- Upload date:
- Size: 6.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4de974f1224c7da15b3ddf4d5d9897ff0c1bfdb2b26f272c466e3b9ef539f61c
|
|
| MD5 |
8020f6b9f16b8a172bcd18fe38bc4f04
|
|
| BLAKE2b-256 |
d5d21f0b3b9b70305c5bd16739abb15fad11f928c376cdd03d4f3bdda4d61d6d
|
File details
Details for the file decrypt-1.1.0-py3-none-any.whl.
File metadata
- Download URL: decrypt-1.1.0-py3-none-any.whl
- Upload date:
- Size: 6.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c3aa90d6fa79e846beb357e2718e0042e3f0955c93616915ca1e80165cf004eb
|
|
| MD5 |
a1de1b5b9db440a9b0a92580c9944134
|
|
| BLAKE2b-256 |
0d030336af1c030049aac81107733b6e786b8c5aaa95951a5486eb60ea8189e1
|