Metadata-Version: 2.4
Name: ai-assistant-cli
Version: 0.1.0
Summary: AI-powered CLI assistant using Gemini API
Author: Ruchira
License: MIT
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: PyMuPDF
Requires-Dist: python-docx
Requires-Dist: openpyxl
Requires-Dist: python-pptx
Requires-Dist: Pillow

# 🚀 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 


