v1.2.1 • Powered by Gemini 3 & Gemma 3

Git-Alchemist

A unified AI stack to optimize, describe, and architect your GitHub repositories. Turn raw code into technical gold.

View on GitHub View Examples

Quick Install

Global Library Setup

Install once via pip, run everywhere.

pip install git-alchemist

API Key Setup

Requirement: Get your free API key from Google AI Studio.

Windows (PowerShell)

$env:GEMINI_API_KEY="your_key_here"

To make it permanent, add it to your profile or use System Environment Variables.

Linux / macOS

export GEMINI_API_KEY="your_key_here"

Add to ~/.bashrc or ~/.zshrc to make it permanent.

Using a .env file (Project specific)

Create a file named .env in your project root:

GEMINI_API_KEY=your_actual_key_here

Built for these challenges

Automate GitHub Profile README

Tired of manually listing projects? The Alchemist analyzes your actual code history to build a professional profile automatically.

Generate Repo Topics & Tags

Boost repository discoverability. Use AI to suggest search-friendly GitHub topics based on your project content.

Safe Project Scaffolding

Generate complex project structures in temporary, isolated workspaces before committing them to your system.

Semantic Commit Messages

Clean up your history. Get professional, AI-powered git commit message suggestions based on your staged changes.

Codebase Audit & Health

Transmute lead repos into gold. Audit your projects for professional standards like Licenses, CI/CD, and metadata.

The Sage & Helper

Navigate your codebase with a parallel-processing AI architect. Chunking engine handles large repos instantly.

Prefer a Dashboard?

Host the entire Alchemist stack as a Docker container with AI-Stack-Manager. Manage repositories, topics, and architecture from a beautiful web interface.

Explore AI-Stack-Manager
Web Dashboard Active

Quick Start Guide

1. Authenticate GitHub CLI Ensure you are logged in: gh auth login
2. Start the Transmutation Optimize your profile or repo metadata: alchemist topics --smart
3. Ask for Help Launch the interactive assistant: alchemist helper
Built by abduznik • Distributed under MIT License