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 helperfor a guided experience through your project.
Installation
-
Clone the repository:
git clone https://github.com/abduznik/Git-Alchemist.git cd Git-Alchemist
-
Install as a Global Library:
pip install git-alchemist
-
Set up your Environment: Create a
.envfile 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-ProfileAI-Gen-TopicsAI-Gen-DescriptionAI-Gen-IssueAi-Pro-Arch
Created by abduznik
Metadata
Release files for git-alchemist 1.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| git_alchemist-1.3.0.tar.gz | 24.1 kB | Without provenance | Details for git_alchemist-1.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| git_alchemist-1.3.0-py3-none-any.whl | Python 3 | none | any | Details for git_alchemist-1.3.0-py3-none-any.whl |
Total release size: 53.3 kB
Release files / git_alchemist-1.3.0.tar.gz
| Download URL | git_alchemist-1.3.0.tar.gz |
|---|---|
| Size | 24.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eb85db16152fdbb5aef77b0458c6ca871b645eaa8996e2d2c6644ca494bc90a8
|
|
BLAKE2b-256 checksum How to use checksums |
f340d625dd268b7cd206c661954bdab3d9d9203bae20c36cf1d67b2443f62b1a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / git_alchemist-1.3.0-py3-none-any.whl
| Download URL | git_alchemist-1.3.0-py3-none-any.whl |
|---|---|
| Size | 29.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1dba27d56d4d154ae72f981fbd01157b129d08d9b7f03ca0bf04dc67a855d58a
|
|
BLAKE2b-256 checksum How to use checksums |
45c77e4bc6be88db8f94b6f6967132cf51efd6e6941b32fe87adfc7468986a9e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for git-alchemist 1.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.