✨ Features

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

📦 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
NVIDIA_API_KEY=your_key_here
GITHUB_TOKEN=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

⚡ Quick Start

babin c                           # Start chat (Groq - llama-3.3-70b)
babin -p github c                 # Chat with GPT-5 Nano
babin -p gemini c                 # Chat with Gemini (Global flag)
babin a "What is Python?"         # Quick question
babin -f main.py a "Explain"      # Analyze file (Global flag)
babin h                           # View history (After session ends)
babin -p gemini c                 # Chat with Gemini (Global flag)
babin lm                          # List available models

🕒 Chat History Note

All sessions are saved in ~/.babincli_history/. To see your latest session in history, you must exit the current chat (type exit or quit). History is written to disk only after the session is terminated.

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 v1.3.7 && git push origin v1.3.7 (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.

⭐ Support

If you find this useful, please give it a star on GitHub! It helps me keep building.