Skip to main content

BabinCLI: A powerful, interactive terminal assistant powered by Gemini.

Project description

BabinCLI

PyPI version Python 3.9+ License: 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)

pip install babincli

Install from GitHub

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:

    git clone https://github.com/KGFCH2/BabinCLI.git
    cd BabinCLI
    
  2. Install the package locally:

    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:

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):

$env:GEMINI_API_KEY="your_api_key_here"

Windows (Command Prompt):

set GEMINI_API_KEY=your_api_key_here

Linux or macOS:

export GEMINI_API_KEY="your_api_key_here"

Usage

Interactive Chat Mode

Run the following command to start a continuous conversation:

babin chat

To use a specific model (e.g., if you hit quota limits):

babin --model gemini-flash-latest chat

Single Question

Ask a quick question without entering chat mode:

babin ask "How do I create a list in Python?"

List Available Models

Check which models your API key has access to:

babin list-models

Documentation

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

babincli-1.0.0.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

babincli-1.0.0-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

Details for the file babincli-1.0.0.tar.gz.

File metadata

  • Download URL: babincli-1.0.0.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for babincli-1.0.0.tar.gz
Algorithm Hash digest
SHA256 ca7459126f1e9e11b402003405513165b9cea24bb993f16efcd3286354f53a52
MD5 3a8081733ef445421abe63d18941f14c
BLAKE2b-256 6fd595ffb115825714325f6a956f5e9d468b63ceac8ef7266aa39b926f05ec4b

See more details on using hashes here.

File details

Details for the file babincli-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: babincli-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 5.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for babincli-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 230797aaccc5fc7f3101a66b3715e40d1c445c67a764f26ac7c0bd16d3cc80ca
MD5 ac0f9fb23bc8ac13dd6fcdfe29794009
BLAKE2b-256 e58b288199ba38465e4d9838151b0fc4834426d9afd09bc3c3c0734863ee2674

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page