Git-Alchemist ⚗️

Git-Alchemist ⚗️ is a unified AI-powered CLI tool for automating GitHub repository management. It consolidates multiple technical utilities into a single, intelligent system powered by Google's Gemini 3 and Gemma 3 models.

🌐 Visit the Official Site

Features

• Smart Profile Generator: Intelligently generates or updates your GitHub Profile README.
• Topic Generator: Auto-tag your repositories with AI-suggested topics for better discoverability.
• Description Refiner: Automatically generates repository descriptions by analyzing your README content.
• Issue Drafter: Translates loose ideas into structured, technical GitHub Issue drafts.
• Architect (Scaffold): Generates and executes project scaffolding commands in a safe, temporary workspace.
• Fix & Explain: Apply AI-powered patches to specific files or get concise technical explanations for complex code.
• Gold Score Audit: Measure your repository's professional quality and health.
• The Sage & Helper: Contextual codebase chat and interactive assistant, now powered by a Smart Chunking Engine to handle large codebases seamlessly.
• Commit Alchemist: Automated semantic commit message suggestions from staged changes.
• Forge: Automated PR creation from local changes.

Model Tiers (v1.2.0)

Git-Alchemist features a dynamic model selection and fallback system with strict separation for stability:

• Fast Mode (Default): Utilizes Gemma 3 (27B, 12B, 4B). Optimized for speed, local-like reasoning, and high availability.
• Smart Mode (--smart): Utilizes Gemini 3 Flash, Gemini 2.5 Flash, and Flash-Lite. Optimized for complex architecture, deep code analysis, and large context windows.

New in v1.2.0:

• Parallel Map-Reduce: Large codebases are automatically split into chunks and processed in parallel (up to 2 workers) for faster, deeper insights without hitting token limits.
• Interactive Helper: Use alchemist helper for a guided experience through your project.

Installation

1. Clone the repository:

   git clone https://github.com/abduznik/Git-Alchemist.git
   cd Git-Alchemist
   

2. Install as a Global Library:

   pip install git-alchemist
   

3. Set up your Environment: Create a .env file in the directory or export it in your shell:

   GEMINI_API_KEY=your_actual_api_key_here
   

Usage

Once installed, you can run the alchemist command from any directory:

# Audit a repository
alchemist audit

# Optimize repository topics
alchemist topics

# Generate semantic commit messages
alchemist commit

# Ask the Sage a question
alchemist sage "How does the audit scoring work?"

# Start the interactive helper
alchemist helper

# Scaffold a new project (Safe Mode)
alchemist scaffold "A FastAPI backend with a React frontend" --smart

Requirements

• Python 3.10+
• GitHub CLI (gh) installed and authenticated (gh auth login).
• A Google Gemini API Key.

Migration Note

This tool replaces and consolidates the following legacy scripts:

• AI-Gen-Profile
• AI-Gen-Topics
• AI-Gen-Description
• AI-Gen-Issue
• Ai-Pro-Arch

Created by abduznik