gitsage-local 0.1.3__tar.gz

gitsage_local-0.1.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mathys Dupont
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gitsage_local-0.1.3/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: gitsage-local
+Version: 0.1.3
+Summary: Local LLM powered Git commit generator
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: pyperclip
+Requires-Dist: toml
+Dynamic: license-file
+
+# GitSage
+![logo](ressources/logo.png)
+
+Local AI powered commit generator based on ur repository local change.
+
+## Installation
+
+### Prerequirements
+
+    - Python>=3.10
+    - Python3-pip or Python3-pipx
+    - Python3-venv (optional if using pipx)
+    - Ollama
+
+#### Start Ollama
+
+```bash
+$> ollama pull qwen3:8b (or the model of your choice)
+```
+
+#### Create your virtual environnent (if using pip)
+
+```bash
+$> python3 -m venv .venv
+```
+
+##### Use your virtual environnement
+
+```bash
+$> source .venv/bin/activate
+```
+
+### Install GitSage
+
+#### with pip :
+
+```bash
+(.venv) $> pip install gitsage
+```
+
+#### with pipx :
+
+```bash
+$> pipx install gitsage
+```
+
+## Usage
+
+```bash
+$> gitsage <command> <options>
+```
+
+### Commands
+
+    help                   Show this help message
+    commit                 Generate a commit message based on the staged changes
+    version/-v/--version   Show the version of GitSage
+
+### Options
+
+    --copy            Copy the output to the clipboard
+
+## Configuration
+
+The default configuration file is located at `~/.config/gitsage/config.toml`. If the file does not exist, it will be created with default values when you run the tool for the first time.
+
+### Default Configuration :
+
+```toml
+model = "qwen3:8b"
+prompt = """You generate Git commit messages.
+
+Analyze the following staged git diff.
+
+Return ONLY a single Conventional Commit message.
+Format:
+type(scope): description
+
+Rules:
+- Use feat, fix, refactor, docs, test, chore, or perf
+- Keep the description concise
+- Use imperative mood
+- Do not invent changes
+- Do not include markdown
+
+"""
+ollama_url = "http://localhost:11434"
+```
+
+You can modify the `model`, `prompt`, and `ollama_url` values in the configuration file to customize the behavior of GitSage according to your needs.

gitsage_local-0.1.3/README.md

@@ -0,0 +1,90 @@
+# GitSage
+![logo](ressources/logo.png)
+
+Local AI powered commit generator based on ur repository local change.
+
+## Installation
+
+### Prerequirements
+
+    - Python>=3.10
+    - Python3-pip or Python3-pipx
+    - Python3-venv (optional if using pipx)
+    - Ollama
+
+#### Start Ollama
+
+```bash
+$> ollama pull qwen3:8b (or the model of your choice)
+```
+
+#### Create your virtual environnent (if using pip)
+
+```bash
+$> python3 -m venv .venv
+```
+
+##### Use your virtual environnement
+
+```bash
+$> source .venv/bin/activate
+```
+
+### Install GitSage
+
+#### with pip :
+
+```bash
+(.venv) $> pip install gitsage
+```
+
+#### with pipx :
+
+```bash
+$> pipx install gitsage
+```
+
+## Usage
+
+```bash
+$> gitsage <command> <options>
+```
+
+### Commands
+
+    help                   Show this help message
+    commit                 Generate a commit message based on the staged changes
+    version/-v/--version   Show the version of GitSage
+
+### Options
+
+    --copy            Copy the output to the clipboard
+
+## Configuration
+
+The default configuration file is located at `~/.config/gitsage/config.toml`. If the file does not exist, it will be created with default values when you run the tool for the first time.
+
+### Default Configuration :
+
+```toml
+model = "qwen3:8b"
+prompt = """You generate Git commit messages.
+
+Analyze the following staged git diff.
+
+Return ONLY a single Conventional Commit message.
+Format:
+type(scope): description
+
+Rules:
+- Use feat, fix, refactor, docs, test, chore, or perf
+- Keep the description concise
+- Use imperative mood
+- Do not invent changes
+- Do not include markdown
+
+"""
+ollama_url = "http://localhost:11434"
+```
+
+You can modify the `model`, `prompt`, and `ollama_url` values in the configuration file to customize the behavior of GitSage according to your needs.

gitsage_local-0.1.3/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gitsage-local"
+version = "0.1.3"
+description = "Local LLM powered Git commit generator"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "requests",
+    "pyperclip",
+    "toml",
+]
+
+[project.scripts]
+gitsage = "gitsage.cli:main"

gitsage_local-0.1.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

gitsage_local-0.1.3/src/gitsage/cli.py

@@ -0,0 +1,37 @@
+import gitsage.utils as utils
+import sys
+
+def commit(copy=False):
+    if not utils.check_ollama():
+        utils.print_error("Ollama is not running.\nTry:\n\t> ollama pull 'your model'")
+        sys.exit(1)
+    config = utils.load_config()
+    diff = utils.get_diff()
+    commit = utils.generate_commit_message(diff, config)
+    if copy:
+        utils.copy_to_clipboard(commit)
+
+def main():
+    if len(sys.argv) < 2:
+        utils.draw_logo()
+        utils.print_help()
+        return 1
+
+    if sys.argv[1] in ["help", "-h", "--help"]:
+        utils.draw_logo()
+        utils.print_help()
+        return 0
+
+    if sys.argv[1] in ["version", "-v", "--version"]:
+        utils.print_version()
+        return 0
+
+    command = sys.argv[1]
+    copy = sys.argv[2] == "--copy" if len(sys.argv) > 2 else False
+
+    if command == "commit":
+        commit(copy=copy)
+    else:
+        utils.print_error(f"Unknown command: {command}\n")
+        print("Usage: gitsage <command> <options>")
+        return 1

gitsage_local-0.1.3/src/gitsage/utils.py

@@ -0,0 +1,135 @@
+import requests
+import sys
+import subprocess
+import json
+import pyperclip
+from pathlib import Path
+import toml
+import os
+from importlib.metadata import version
+
+def load_config():
+    DEFAULT_CONFIG = '''\
+model = "qwen3:8b"
+prompt = """You generate Git commit messages.\n\nAnalyze the following staged git diff.\n\nReturn ONLY a single Conventional Commit message.\nFormat:\ntype(scope): description\n\nRules:\n- Use feat, fix, refactor, docs, test, chore, or perf\n- Keep the description concise\n- Use imperative mood\n- Do not invent changes\n- Do not include markdown\n\n"""
+ollama_url = "http://localhost:11434"
+'''
+
+    config_path = Path.home() / ".config/gitsage/config.toml"
+    if not os.path.exists(config_path):
+        config_path.parent.mkdir(parents=True, exist_ok=True)
+        with open(config_path, "w") as f:
+            f.write(DEFAULT_CONFIG)
+    try:
+        with open(config_path, "r") as f:
+            return toml.load(f)
+    except FileNotFoundError:
+        print_error(f"Config file not found at {config_path}.")
+        sys.exit(1)
+    except toml.TomlDecodeError:
+        print_error("Invalid TOML in config.toml.")
+        sys.exit(1)
+
+def check_ollama():
+    try:
+        response = requests.get(
+            "http://localhost:11434/api/tags",
+            timeout=2
+        )
+        response.raise_for_status()
+        return True
+    except requests.RequestException:
+        return False
+
+def get_diff():
+    try:
+        result = subprocess.run(
+            ["git", "diff", "--cached"],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        return result.stdout
+    except subprocess.CalledProcessError as e:
+        print_error(f"Failed to get git diff: {e}")
+        sys.exit(1)
+
+def generate_commit_message(diff, config):
+    response = requests.post(
+        config["ollama_url"] + "/api/generate",
+        json={
+            "model": config["model"],
+            "system": config["prompt"],
+        "prompt": f"Analyze this staged git diff:\n\n{diff}",
+        "stream": True,
+        "think": False,
+    },
+    stream=True,
+    )
+    output = ""
+    for line in response.iter_lines():
+        if not line:
+            continue
+        data = json.loads(line)
+        if data.get("response") != "":
+            output += data["response"]
+            print(data["response"], end="", flush=True)
+    print()
+    return output
+
+def draw_logo():
+    GREEN = "\033[38;5;71m"
+    RESET = "\033[0m"
+
+    print(f"""{GREEN}
+                              ████████
+                              ██    ██
+        ████                  ██    ██
+           ███                ████████
+             ███                 █
+               ███               █     ████████
+                 ████            ████████    ██
+               ███               █     ██    ██
+             ███                 █     ████████
+           ███                ███████
+         ███                  ██   ██
+                              ██   ██
+            ████████████      ███████{RESET}
+""")
+
+def copy_to_clipboard(text):
+    try:
+        pyperclip.copy(text)
+        print()
+        print_info("Output copied to clipboard.")
+    except pyperclip.PyperclipException:
+        print_error(f"Failed to copy to clipboard.\n")
+        print_warning("Ensure you have a clipboard utility installed !")
+
+def print_help():
+    print("Usage: gitsage <command> <options>\n")
+    print("Commands:\n")
+    print("  help                   Show this help message")
+    print("  commit                 Generate a commit message based on the staged changes")
+    print("  version/-v/--version   Show the version of GitSage\n")
+    print("Options:\n")
+    print("  --copy            Copy the output to the clipboard")
+
+
+def print_version():
+    print(f"GitSage v{version('gitsage')}")
+
+def print_error(message):
+    RED = "\033[31m"
+    RESET = "\033[0m"
+    print(f"{RED}[ERROR]: {message}{RESET}")
+
+def print_warning(message):
+    YELLOW = "\033[33m"
+    RESET = "\033[0m"
+    print(f"{YELLOW}[WARNING]: {message}{RESET}")
+
+def print_info(message):
+    BLUE = "\033[34m"
+    RESET = "\033[0m"
+    print(f"{BLUE}[INFO]: {message}{RESET}")

gitsage_local-0.1.3/src/gitsage_local.egg-info/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: gitsage-local
+Version: 0.1.3
+Summary: Local LLM powered Git commit generator
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: pyperclip
+Requires-Dist: toml
+Dynamic: license-file
+
+# GitSage
+![logo](ressources/logo.png)
+
+Local AI powered commit generator based on ur repository local change.
+
+## Installation
+
+### Prerequirements
+
+    - Python>=3.10
+    - Python3-pip or Python3-pipx
+    - Python3-venv (optional if using pipx)
+    - Ollama
+
+#### Start Ollama
+
+```bash
+$> ollama pull qwen3:8b (or the model of your choice)
+```
+
+#### Create your virtual environnent (if using pip)
+
+```bash
+$> python3 -m venv .venv
+```
+
+##### Use your virtual environnement
+
+```bash
+$> source .venv/bin/activate
+```
+
+### Install GitSage
+
+#### with pip :
+
+```bash
+(.venv) $> pip install gitsage
+```
+
+#### with pipx :
+
+```bash
+$> pipx install gitsage
+```
+
+## Usage
+
+```bash
+$> gitsage <command> <options>
+```
+
+### Commands
+
+    help                   Show this help message
+    commit                 Generate a commit message based on the staged changes
+    version/-v/--version   Show the version of GitSage
+
+### Options
+
+    --copy            Copy the output to the clipboard
+
+## Configuration
+
+The default configuration file is located at `~/.config/gitsage/config.toml`. If the file does not exist, it will be created with default values when you run the tool for the first time.
+
+### Default Configuration :
+
+```toml
+model = "qwen3:8b"
+prompt = """You generate Git commit messages.
+
+Analyze the following staged git diff.
+
+Return ONLY a single Conventional Commit message.
+Format:
+type(scope): description
+
+Rules:
+- Use feat, fix, refactor, docs, test, chore, or perf
+- Keep the description concise
+- Use imperative mood
+- Do not invent changes
+- Do not include markdown
+
+"""
+ollama_url = "http://localhost:11434"
+```
+
+You can modify the `model`, `prompt`, and `ollama_url` values in the configuration file to customize the behavior of GitSage according to your needs.

gitsage_local-0.1.3/src/gitsage_local.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/gitsage/__init__.py
+src/gitsage/cli.py
+src/gitsage/utils.py
+src/gitsage_local.egg-info/PKG-INFO
+src/gitsage_local.egg-info/SOURCES.txt
+src/gitsage_local.egg-info/dependency_links.txt
+src/gitsage_local.egg-info/entry_points.txt
+src/gitsage_local.egg-info/requires.txt
+src/gitsage_local.egg-info/top_level.txt

gitsage_local-0.1.3/src/gitsage_local.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

gitsage_local-0.1.3/src/gitsage_local.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gitsage = gitsage.cli:main

gitsage_local-0.1.3/src/gitsage_local.egg-info/requires.txt

@@ -0,0 +1,3 @@
+requests
+pyperclip
+toml

gitsage_local-0.1.3/src/gitsage_local.egg-info/top_level.txt

@@ -0,0 +1 @@
+gitsage