https://github.com/abduznik/Git-Alchemist
Transform Git history: rewrite, clean, and optimize your repositories with ease.
https://github.com/abduznik/Git-Alchemist
ai automation cli developer-tools gemini gemma git git-management github llm productivity python repository-manager version-control
Last synced: 2 months ago
JSON representation
Transform Git history: rewrite, clean, and optimize your repositories with ease.
- Host: GitHub
- URL: https://github.com/abduznik/Git-Alchemist
- Owner: abduznik
- License: mit
- Created: 2026-02-03T15:52:31.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-02-13T09:37:44.000Z (3 months ago)
- Last Synced: 2026-02-13T17:43:23.604Z (3 months ago)
- Topics: ai, automation, cli, developer-tools, gemini, gemma, git, git-management, github, llm, productivity, python, repository-manager, version-control
- Language: Python
- Size: 748 KB
- Stars: 4
- Watchers: 0
- Forks: 6
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-gemini-cli - Git-Alchemist - A unified AI-powered CLI tool for automating GitHub repository management (issues, PRs, topics, profiles) powered by Gemini 3 and Gemma 3. ([Non-Gemini CLI](#non-gemini-cli)) (:tada: New)
README
# 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](https://abduznik.github.io/Git-Alchemist/)
---
## 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:**
```bash
git clone https://github.com/abduznik/Git-Alchemist.git
cd Git-Alchemist
```
2. **Install as a Global Library:**
```bash
pip install git-alchemist
```
3. **Set up your Environment:**
Create a `.env` file in the directory or export it in your shell:
```env
GEMINI_API_KEY=your_actual_api_key_here
```
## Usage
Once installed, you can run the `alchemist` command from **any directory**:
```bash
# 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](https://github.com/abduznik)*