🚀 AI Assistant & Command Generator CLI
A powerful menu-driven Python Command Line Interface (CLI) designed to enhance developer productivity and streamline technical documentation.
It combines the intelligence of the Gemini API for analysis and code generation with a robust local 📚 Recipe Vault for storing essential shell commands.
✨ Key Features & Benefits
- ⚡ Zero-Setup Demo → Works on Windows, macOS, or Linux using simple environment variables.
- 🧠 Intelligent Assistance → Real-time web search, code explanations, and file summarization.
- 🛠️ Developer Productivity → Automates creation and explanation of complex Linux/CLI commands.
💡 AI Analysis & Generation Features
| Feature | Description |
|---|---|
| 🗣 General Q&A (Web Search) | Get up-to-date, grounded answers with Google Search integration. |
| 💻 Explain Code Snippet | Paste any code block and get a simple, clear explanation of its purpose. |
| 💡 Code Generator (NEW!) | Generate runnable scripts/functions (e.g., Python script for file hashing). |
| 📝 Summarize Local File | Summarizes text from TXT, MD, PDF, DOCX, XLSX, and Images. |
📚 Command Recipe Vault (Persistence)
| Action | Description |
|---|---|
| 🛠 Generate New Recipe (AI) | Describe a command, and AI generates & saves it. |
| ➕ Add Known Recipe (Manual) | Save a command you already know with tags & names. |
| 🔍 Search & View Recipe | Find commands by name or tag, ready for instant copy/paste. |
| 🧠 Explain Recipe (AI) | Get detailed explanations of flags, pipes, and syntax. |
🛠️ Project Setup (Windows/VS Code Optimized)
1️⃣ API Key Configuration (Crucial!)
You must obtain a Gemini API Key from Google AI Studio and set it as an environment variable named GEMINI_API_KEY.
💻 Setting the Environment Variable:
Run the command corresponding to your operating system before running the Python script.
| Operating System | Command |
|---|---|
| 🪟 Windows PowerShell / VS Code | powershell $env:GEMINI_API_KEY='YOUR_KEY_HERE' |
| 🍎 macOS / 🐧 Linux (Bash/Zsh) | bash export GEMINI_API_KEY='YOUR_KEY_HERE' |
🔑 Replace
YOUR_KEY_HEREwith your actual API key. The quotes are important!
2️⃣ Install Dependencies
Gemini api is used in this
2 maintainers
Metadata
2 maintainers
Release files for ai-assistant-cli 0.2.0
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 | |
|---|---|---|---|---|
| ai_assistant_cli-0.2.0.tar.gz | 6.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ai_assistant_cli-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.5 kB
Release files / ai_assistant_cli-0.2.0.tar.gz
| Download URL | ai_assistant_cli-0.2.0.tar.gz |
|---|---|
| Size | 6.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ef6a60d21f3ee348e11cb6ba186e1e7794ed7d7f085741dc820b3fbfb25c18a0
|
|
BLAKE2b-256 checksum How to use checksums |
7b67a40b9dd27f9bb8463fa94f482dfde388c0577289c496058c97e68d89b638
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.9
|
Release files / ai_assistant_cli-0.2.0-py3-none-any.whl
| Download URL | ai_assistant_cli-0.2.0-py3-none-any.whl |
|---|---|
| Size | 6.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9198ef2b7232c214c872b9092e41814f434fbfd49edad8cc1ef4aee323cde912
|
|
BLAKE2b-256 checksum How to use checksums |
df759e4e36008a67b284b2d89e661cdd318837d31f1dc50e4e38d4b0120a656e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.9
|
Security for ai-assistant-cli 0.2.0
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.
