PACKAGE EXPLORERView in registry

ai-assistant-cli

PyPI

AI-powered CLI assistant using Gemini API

Versions collected1

Direct dependencies6From release 0.2.0

Last observed21 Oct, 09:57 UTC

README

Version 0.2.0 documentation

🚀 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

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases

Version	Published	Direct dependencies	Open version
0.2.0	17 Jan 2026	6

Package advisories

No matching advisories collected

This describes our collected data; it is not a security assessment.

Metadata history

Meaningful changes

Current collected state Current

Observed since 21 Oct, 09:57 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:dc23b5bcadf043e9b51d0f5ca557045437616ff59d5333b3246ba98bdc84959a