Metadata-Version: 2.4
Name: babincli
Version: 1.0.0
Summary: BabinCLI: A powerful, interactive terminal assistant powered by Gemini.
Author-email: KGFCH2 <your-email@example.com>
License: MIT
Project-URL: Homepage, https://github.com/KGFCH2/BabinCLI
Project-URL: Documentation, https://KGFCH2.github.io/BabinCLI/
Project-URL: Repository, https://github.com/KGFCH2/BabinCLI
Project-URL: Bug Tracker, https://github.com/KGFCH2/BabinCLI/issues
Keywords: cli,gemini,ai,terminal,assistant,chatbot
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Requires-Dist: google-generativeai>=0.3.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.0
Dynamic: license-file

# BabinCLI

[![PyPI version](https://badge.fury.io/py/babincli.svg)](https://pypi.org/project/babincli/)
[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

BabinCLI is a powerful terminal assistant powered by Google's Gemini AI. It provides an interactive interface for chatting and a direct command for single queries.

## Features
- Interactive Chat: Continuous conversation with memory.
- Formatted Output: Markdown support for clear terminal responses.
- Model Selection: Ability to switch between different Gemini models.
- Cross-platform: Works on Windows, macOS, and Linux.

## Prerequisites
- Python 3.9 or higher.
- A Gemini API Key from Google AI Studio.

## Installation

### Install from PyPI (Recommended)
```bash
pip install babincli
```

### Install from GitHub
```bash
pip install git+https://github.com/KGFCH2/BabinCLI.git
```

### Install from Source
If you have downloaded or cloned the source code:
1. Clone the repository:
   ```bash
   git clone https://github.com/KGFCH2/BabinCLI.git
   cd BabinCLI
   ```

2. Install the package locally:
   ```bash
   pip install .
   ```

Note for Windows Users: If the "babin" command is not recognized after installation, ensure that your Python Scripts folder is added to your System PATH. Alternatively, you can run the tool using:
```bash
python -m babin_cli.main chat
```

## Configuration

You must set your Gemini API Key as an environment variable for the tool to function.

Windows (PowerShell):
```powershell
$env:GEMINI_API_KEY="your_api_key_here"
```

Windows (Command Prompt):
```cmd
set GEMINI_API_KEY=your_api_key_here
```

Linux or macOS:
```bash
export GEMINI_API_KEY="your_api_key_here"
```

## Usage

### Interactive Chat Mode
Run the following command to start a continuous conversation:
```bash
babin chat
```

To use a specific model (e.g., if you hit quota limits):
```bash
babin --model gemini-flash-latest chat
```

### Single Question
Ask a quick question without entering chat mode:
```bash
babin ask "How do I create a list in Python?"
```

### List Available Models
Check which models your API key has access to:
```bash
babin list-models
```

## Documentation
Additional documentation and download instructions are available at https://KGFCH2.github.io/BabinCLI/
