Skip to main content

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 --staged to 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 via tenacity to 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

decrypt-1.1.0.tar.gz (6.1 kB view details)

Uploaded Source

Built Distribution

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

decrypt-1.1.0-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

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

Hashes for decrypt-1.1.0.tar.gz
Algorithm Hash digest
SHA256 4de974f1224c7da15b3ddf4d5d9897ff0c1bfdb2b26f272c466e3b9ef539f61c
MD5 8020f6b9f16b8a172bcd18fe38bc4f04
BLAKE2b-256 d5d21f0b3b9b70305c5bd16739abb15fad11f928c376cdd03d4f3bdda4d61d6d

See more details on using hashes here.

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

Hashes for decrypt-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c3aa90d6fa79e846beb357e2718e0042e3f0955c93616915ca1e80165cf004eb
MD5 a1de1b5b9db440a9b0a92580c9944134
BLAKE2b-256 0d030336af1c030049aac81107733b6e786b8c5aaa95951a5486eb60ea8189e1

See more details on using hashes here.

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