babincli 1.2.0

BabinCLI: A powerful, interactive terminal assistant powered by Gemini 2.5 Flash & Groq with weather integration.

🤖 BabinCLI

AI-powered terminal assistant with Gemini 2.5 Flash & Groq

📦 Install · ⚡ Quick Start · 📖 Full Guide · 🌐 Portal

---

✨ Features

	Feature	Description
🔄	Multi-Provider	Gemini + Groq with automatic fallback
🔑	Multi-Key Rotation	Comma-separated Gemini keys = multiplied quota
🌤️	Live Weather	Real-time weather data injected into responses
📅	Date-Aware	AI always knows today's date and time
⌨️	Shortcuts	babin a, babin c, babin lm, -p, -m
🔀	Mid-Chat Switch	Type switch to change models on-the-fly
💬	Interactive Chat	Continuous conversation with memory
🎨	Rich Output	Beautiful markdown formatting in terminal

---

📦 Installation

pip install babincli

Or install from GitHub: pip install git+https://github.com/KGFCH2/BabinCLI.git

---

⚙️ Quick Setup

Copy .env.example to .env and add your API keys:

GEMINI_API_KEY=your_key_here
GROQ_API_KEY=your_key_here
OPENWEATHERMAP_API_KEY=your_key_here    # optional
WEATHERAPI_KEY=your_key_here            # optional

🔑 Multi-key: Use GEMINI_API_KEY=key1,key2,key3 to multiply your daily quota!

Get free keys: Google AI Studio · Groq Console

---

⚡ Quick Start

babin c                         # 💬 Start chat (Gemini 2.5 Flash)
babin a "What is Python?"       # ❓ Quick question
babin -p groq c                 # 🔄 Chat with Groq
babin lm                        # 📃 List available models

🔀 Switch Models Mid-Chat

Type switch during any chat session to see a numbered menu of available models and switch instantly — no restart needed!

---

📖 Full Documentation

See INSTRUCTIONS.md for the complete guide including:

• Detailed configuration for all platforms
• All commands with examples
• Multi-key rotation explained
• Auto-fallback behavior
• Local development & testing
• Troubleshooting

---

🌐 Portal

Visit KGFCH2.github.io/BabinCLI for the interactive documentation portal with code examples and AI helper.

---

📤 Publishing to PyPI

This project uses GitHub Actions for automatic PyPI publishing:

1. Bump version in pyproject.toml and babin_cli/__init__.py
2. Push to GitHub
3. Go to Releases → Create a new release → tag (e.g. v1.2.0) → Publish
4. ✅ The workflow auto-builds and uploads to PyPI

⚠️ PyPI does not auto-sync with GitHub pushes. You must create a Release to trigger publishing.

🔧 First-time: Add a "Trusted Publisher" on pypi.org → Project Settings → Publishing → add your GitHub repo details.

---

📄 License

MIT License © 2026 Babin Bid