babincli 1.3.5

BabinCLI: A powerful assistant powered by NVIDIA, GitHub Models, OpenRouter, Gemini & Groq.

🤖 BabinCLI

My AI-powered terminal assistant built with Gemini 2.5 Flash, Groq, NVIDIA, GitHub, and OpenRouter

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

---

✨ Features

This CLI tool is my personal assistant, and I've packed it with features I use every day:

Feature	Description
Multi-Provider	Gemini, Groq, NVIDIA, GitHub, & OpenRouter
Streaming Output	Real-time response generation (v1.3.5)
Web Search	Automatic DuckDuckGo search for live info (v1.3.5)
File Context	Inject file content into AI prompt with -f (v1.3.5)
Persistent History	Conversations saved automatically for later view (v1.3.5)
Real-time Stream	Premium live response generation (v1.3.5)
Multi-Key Rotation	Comma-separated Gemini keys for multiplied quota
Live Weather	Real-time weather data injected into responses
Mid-Chat Switch	Change models on-the-fly without restarting
Shortcuts	Quick commands like babin a, babin c, babin h
Global Options	Use -p, -m, -f anywhere in the command

---

📦 Installation

pip install babincli

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

Windows: BabinCLI auto-fixes PATH on first run. If babin isn't recognized, run python -m babin_cli setup-path and open a new terminal.

---

⚙️ 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 · NVIDIA · GitHub · OpenRouter

---

⚡ Quick Start

babin c                           # Start chat (Groq - llama-3.3-70b)
babin -p github c                 # Chat with GPT-5 Nano
babin -p openrouter c             # Chat with Gemma 3
babin a "What is Python?"         # Quick question
babin -f main.py a "Explain"      # Analyze file (Global flag)
babin h                           # View chat history
babin -p gemini c                 # Chat with Gemini (Global flag)
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

🤖 Automated Publishing (GitHub Actions)

This project uses GitHub Actions for automatic PyPI publishing:

1. 🏷️ Bump version in pyproject.toml and babin_cli/__init__.py
2. 💾 Commit changes: git commit -m "Update message" (Updates GitHub only)
3. 🚀 Push Tag: git tag v-1.3.5 && git push origin v-1.3.5 (Updates PyPI automatically)

⚠️ Note: A regular git push will not update PyPI. You must push a version tag to trigger the automation.

📦 Manual Publishing

For manual publishing or testing:

# 1. Install build tools
pip install build twine

# 2. Build the package
python -m build

# 3. Upload to PyPI
python -m twine upload dist/*

⚙️ First-Time Setup

For GitHub Actions:

1. Go to pypi.org → Project Settings → Publishing
2. Add Trusted Publisher with:
   • Owner: KGFCH2
   • Repository: BabinCLI
   • Workflow: publish.yml
   • Environment: pypi
3. Save → GitHub Actions can now publish without tokens.

🔑 Manual Publishing Account: Create account at pypi.org & generate API token.

📖 Detailed Guide: See INSTRUCTIONS.md for comprehensive publishing instructions.

---

📄 License

MIT License © 2026 Babin Bid

Personal project hand-crafted with 💖 by Babin Bid.