PkgFoundry
Catalog PyPI
Back to packageRELEASE DETAILS

0.2.0

PyPI

ai-assistant-cli

AI-powered CLI assistant using Gemini API

Published17 Jan 2026
Direct dependencies6
Transitive dependenciesNot calculated

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

FeatureDescription
🗣 General Q&A (Web Search)Get up-to-date, grounded answers with Google Search integration.
💻 Explain Code SnippetPaste 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 FileSummarizes text from TXT, MD, PDF, DOCX, XLSX, and Images.

📚 Command Recipe Vault (Persistence)

ActionDescription
🛠 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 RecipeFind 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 SystemCommand
🪟 Windows PowerShell / VS Codepowershell $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.

Declared dependencies 6

Native requirements
6 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
requests
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": "",
  "evaluation": "NOT_EVALUATED"
}
requestsruntime
PyMuPDF
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": "",
  "evaluation": "NOT_EVALUATED"
}
PyMuPDFruntime
python-docx
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": "",
  "evaluation": "NOT_EVALUATED"
}
python-docxruntime
openpyxl
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": "",
  "evaluation": "NOT_EVALUATED"
}
openpyxlruntime
python-pptx
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": "",
  "evaluation": "NOT_EVALUATED"
}
python-pptxruntime
Pillow
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": "",
  "evaluation": "NOT_EVALUATED"
}
Pillowruntime

Distribution files

2 collected
ai_assistant_cli-0.2.0-py3-none-any.whl

bdist_wheel · 6.51 KB · Python py3

Source file
ai_assistant_cli-0.2.0.tar.gz

sdist · 6.68 KB · Python source

Source file

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_version:c5f3bed49c3a6b7c48c13663d56ea62bf81fa9dec0d0981bfe902af6a90a4100

Other collected versions

View all collected versions →