ai-assistant-cli 0.1.0

AI-powered CLI assistant using Gemini API

🚀 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_HERE with your actual API key. The quotes are important!

---

2️⃣ Install Dependencies

• Install in editable mode

  pip install -e .

• Launch the CLI

  ai-assistant

---

Gemini api is used in this