Git-Alchemist

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

Star

Quick Install

Global Library Setup

Install once, run everywhere.


                        pip install git-alchemist

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.

Chat with Local Code

The Sage provides a technical lead perspective by meditating on your local source code to answer deep questions.

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. Set your API Key Export your Gemini key or add it to a .env file: export GEMINI_API_KEY=your_key

3. Start the Transmutation Optimize your profile or repo metadata: python3 -m src.cli topics --smart