gac 1.5.1__tar.gz → 1.5.2__tar.gz

{gac-1.5.1 → gac-1.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gac
-Version: 1.5.1
+Version: 1.5.2
 Summary: AI-powered Git commit message generator with multi-provider support
 Project-URL: Homepage, https://github.com/cellwebb/gac
 Project-URL: Documentation, https://github.com/cellwebb/gac#readme
@@ -56,7 +56,7 @@ Description-Content-Type: text/markdown
 
 - **LLM-Powered Commit Messages:** Automatically generates clear, concise, and context-aware commit messages using large language models.
 - **Deep Contextual Analysis:** Understands your code by analyzing staged changes, repository structure, and recent commit history to provide highly relevant suggestions.
-- **Multi-Provider & Model Support:** Flexibly works with leading AI providers (Anthropic, Cerebras, Groq, Ollama, OpenAI, OpenRouter, Z.AI) and models, easily configured through an interactive setup or environment variables.
+- **Multi-Provider & Model Support:** Flexibly works with leading AI providers (Anthropic, Cerebras, Gemini, Groq, OpenAI, OpenRouter, Streamlake/Vanchin, Z.AI) and local providers (LM Studio, Ollama), easily configured through an interactive setup or environment variables.
 - **Seamless Git Workflow:** Integrates smoothly into your existing Git routine as a simple drop-in replacement for `git commit`.
 - **Extensive Customization:** Tailor commit messages to your needs with a rich set of flags, including one-liners (`-o`), AI hints (`-h`), scope inference (`-s`), and specific model selection (`-m`).
 - **Streamlined Workflow Commands:** Boost your productivity with convenient options to stage all changes (`-a`), auto-confirm commits (`-y`), and push to your remote repository (`-p`) in a single step.
@@ -137,9 +137,6 @@ Example `$HOME/.gac.env` output:
 ```env
 GAC_MODEL=anthropic:claude-3-5-haiku-latest
 ANTHROPIC_API_KEY=your_anthropic_key_here
-# Optional: configure OpenRouter
-# GAC_MODEL=openrouter:openrouter/auto
-# OPENROUTER_API_KEY=your_openrouter_key_here
 ```
 
 Alternatively, you can configure `gac` using environment variables or by manually creating/editing the configuration file.
@@ -148,6 +145,9 @@ Alternatively, you can configure `gac` using environment variables or by manuall
 
 You can manage settings in your `$HOME/.gac.env` file using `gac config` commands:
 
+- Streamlake uses inference endpoint IDs instead of model names. When prompted, paste the exact endpoint ID from the Streamlake console.
+- For local providers like Ollama and LM Studio, gac will ask for the base API URL. API keys are optional for these providers unless your instance requires authentication.
+
 - Show config: `gac config show`
 - Set a value: `gac config set GAC_MODEL groq:meta-llama/llama-4-scout-17b-16e-instruct`
 - Get a value: `gac config get GAC_MODEL`

{gac-1.5.1 → gac-1.5.2}/README.md

@@ -14,7 +14,7 @@
 
 - **LLM-Powered Commit Messages:** Automatically generates clear, concise, and context-aware commit messages using large language models.
 - **Deep Contextual Analysis:** Understands your code by analyzing staged changes, repository structure, and recent commit history to provide highly relevant suggestions.
-- **Multi-Provider & Model Support:** Flexibly works with leading AI providers (Anthropic, Cerebras, Groq, Ollama, OpenAI, OpenRouter, Z.AI) and models, easily configured through an interactive setup or environment variables.
+- **Multi-Provider & Model Support:** Flexibly works with leading AI providers (Anthropic, Cerebras, Gemini, Groq, OpenAI, OpenRouter, Streamlake/Vanchin, Z.AI) and local providers (LM Studio, Ollama), easily configured through an interactive setup or environment variables.
 - **Seamless Git Workflow:** Integrates smoothly into your existing Git routine as a simple drop-in replacement for `git commit`.
 - **Extensive Customization:** Tailor commit messages to your needs with a rich set of flags, including one-liners (`-o`), AI hints (`-h`), scope inference (`-s`), and specific model selection (`-m`).
 - **Streamlined Workflow Commands:** Boost your productivity with convenient options to stage all changes (`-a`), auto-confirm commits (`-y`), and push to your remote repository (`-p`) in a single step.
@@ -95,9 +95,6 @@ Example `$HOME/.gac.env` output:
 ```env
 GAC_MODEL=anthropic:claude-3-5-haiku-latest
 ANTHROPIC_API_KEY=your_anthropic_key_here
-# Optional: configure OpenRouter
-# GAC_MODEL=openrouter:openrouter/auto
-# OPENROUTER_API_KEY=your_openrouter_key_here
 ```
 
 Alternatively, you can configure `gac` using environment variables or by manually creating/editing the configuration file.
@@ -106,6 +103,9 @@ Alternatively, you can configure `gac` using environment variables or by manuall
 
 You can manage settings in your `$HOME/.gac.env` file using `gac config` commands:
 
+- Streamlake uses inference endpoint IDs instead of model names. When prompted, paste the exact endpoint ID from the Streamlake console.
+- For local providers like Ollama and LM Studio, gac will ask for the base API URL. API keys are optional for these providers unless your instance requires authentication.
+
 - Show config: `gac config show`
 - Set a value: `gac config set GAC_MODEL groq:meta-llama/llama-4-scout-17b-16e-instruct`
 - Get a value: `gac config get GAC_MODEL`

{gac-1.5.1 → gac-1.5.2}/pyproject.toml

@@ -195,9 +195,9 @@ line-ending = "auto"
 
 [tool.pytest.ini_options]
 markers = [
-    "providers: marks tests that make real API calls to AI providers (deselect with '-m \"not providers\"')",
+    "integration: marks tests that make real API calls to external services (deselect with '-m \"not integration\"')",
 ]
-addopts = "-m 'not providers'"
+addopts = "-m 'not integration'"
 
 [template.plugins.default]
 tests = true

gac-1.5.2/src/gac/__init__.py

@@ -0,0 +1,15 @@
+"""Git Auto Commit (gac) - Generate commit messages using AI."""
+
+from gac.__version__ import __version__
+from gac.ai import generate_commit_message
+from gac.git import get_staged_files, push_changes
+from gac.prompt import build_prompt, clean_commit_message
+
+__all__ = [
+    "__version__",
+    "generate_commit_message",
+    "build_prompt",
+    "clean_commit_message",
+    "get_staged_files",
+    "push_changes",
+]

{gac-1.5.1 → gac-1.5.2}/src/gac/__version__.py

@@ -1,3 +1,3 @@
 """Version information for gac package."""
 
-__version__ = "1.5.1"
+__version__ = "1.5.2"

{gac-1.5.1 → gac-1.5.2}/src/gac/ai.py

@@ -18,6 +18,7 @@ from gac.providers import (
     call_ollama_api,
     call_openai_api,
     call_openrouter_api,
+    call_streamlake_api,
     call_zai_api,
     call_zai_coding_api,
 )
@@ -71,6 +72,7 @@ def generate_commit_message(
         "cerebras": call_cerebras_api,
         "ollama": call_ollama_api,
         "openrouter": call_openrouter_api,
+        "streamlake": call_streamlake_api,
         "zai": call_zai_api,
         "zai-coding": call_zai_coding_api,
         "gemini": call_gemini_api,

{gac-1.5.1 → gac-1.5.2}/src/gac/ai_utils.py

@@ -102,6 +102,7 @@ def generate_with_retries(
         "ollama",
         "openai",
         "openrouter",
+        "streamlake",
         "zai",
         "zai-coding",
     ]

gac-1.5.2/src/gac/init_cli.py

@@ -0,0 +1,116 @@
+"""CLI for initializing gac configuration interactively."""
+
+from pathlib import Path
+
+import click
+import questionary
+from dotenv import set_key
+
+GAC_ENV_PATH = Path.home() / ".gac.env"
+
+
+def _prompt_required_text(prompt: str) -> str | None:
+    """Prompt until a non-empty string is provided or the user cancels."""
+    while True:
+        response = questionary.text(prompt).ask()
+        if response is None:
+            return None
+        value = response.strip()
+        if value:
+            return value
+        click.echo("A value is required. Please try again.")
+
+
+@click.command()
+def init() -> None:
+    """Interactively set up $HOME/.gac.env for gac."""
+    click.echo("Welcome to gac initialization!\n")
+    if GAC_ENV_PATH.exists():
+        click.echo(f"$HOME/.gac.env already exists at {GAC_ENV_PATH}. Values will be updated.")
+    else:
+        GAC_ENV_PATH.touch()
+        click.echo(f"Created $HOME/.gac.env at {GAC_ENV_PATH}.")
+
+    providers = [
+        ("Anthropic", "claude-3-5-haiku-latest"),
+        ("Cerebras", "qwen-3-coder-480b"),
+        ("Gemini", "gemini-2.5-flash"),
+        ("Groq", "meta-llama/llama-4-maverick-17b-128e-instruct"),
+        ("LM Studio", "gemma3"),
+        ("Ollama", "gemma3"),
+        ("OpenAI", "gpt-4.1-mini"),
+        ("OpenRouter", "openrouter/auto"),
+        ("Streamlake", ""),
+        ("Z.AI", "glm-4.5-air"),
+        ("Z.AI Coding", "glm-4.6"),
+    ]
+    provider_names = [p[0] for p in providers]
+    provider = questionary.select("Select your provider:", choices=provider_names).ask()
+    if not provider:
+        click.echo("Provider selection cancelled. Exiting.")
+        return
+    provider_key = provider.lower().replace(".", "").replace(" ", "-")
+
+    is_ollama = provider_key == "ollama"
+    is_lmstudio = provider_key == "lm-studio"
+    is_streamlake = provider_key == "streamlake"
+    is_zai = provider_key in ("zai", "zai-coding")
+
+    if is_streamlake:
+        endpoint_id = _prompt_required_text("Enter the Streamlake inference endpoint ID (required):")
+        if endpoint_id is None:
+            click.echo("Streamlake configuration cancelled. Exiting.")
+            return
+        model_to_save = endpoint_id
+    else:
+        model_suggestion = dict(providers)[provider]
+        model_prompt = f"Enter the model (default: {model_suggestion}):"
+        model = questionary.text(model_prompt, default=model_suggestion).ask()
+        if model is None:
+            click.echo("Model entry cancelled. Exiting.")
+            return
+        model_to_save = model.strip() if model.strip() else model_suggestion
+
+    set_key(str(GAC_ENV_PATH), "GAC_MODEL", f"{provider_key}:{model_to_save}")
+    click.echo(f"Set GAC_MODEL={provider_key}:{model_to_save}")
+
+    if is_ollama:
+        url_default = "http://localhost:11434"
+        url = questionary.text(f"Enter the Ollama API URL (default: {url_default}):", default=url_default).ask()
+        if url is None:
+            click.echo("Ollama URL entry cancelled. Exiting.")
+            return
+        url_to_save = url.strip() if url.strip() else url_default
+        set_key(str(GAC_ENV_PATH), "OLLAMA_API_URL", url_to_save)
+        click.echo(f"Set OLLAMA_API_URL={url_to_save}")
+    elif is_lmstudio:
+        url_default = "http://localhost:1234"
+        url = questionary.text(f"Enter the LM Studio API URL (default: {url_default}):", default=url_default).ask()
+        if url is None:
+            click.echo("LM Studio URL entry cancelled. Exiting.")
+            return
+        url_to_save = url.strip() if url.strip() else url_default
+        set_key(str(GAC_ENV_PATH), "LMSTUDIO_API_URL", url_to_save)
+        click.echo(f"Set LMSTUDIO_API_URL={url_to_save}")
+
+    api_key_prompt = "Enter your API key (input hidden, can be set later):"
+    if is_ollama or is_lmstudio:
+        click.echo(
+            "This provider typically runs locally. API keys are optional unless your instance requires authentication."
+        )
+        api_key_prompt = "Enter your API key (optional, press Enter to skip):"
+
+    api_key = questionary.password(api_key_prompt).ask()
+    if api_key:
+        if is_zai:
+            api_key_name = "ZAI_API_KEY"
+        elif is_lmstudio:
+            api_key_name = "LMSTUDIO_API_KEY"
+        else:
+            api_key_name = f"{provider_key.upper()}_API_KEY"
+        set_key(str(GAC_ENV_PATH), api_key_name, api_key)
+        click.echo(f"Set {api_key_name} (hidden)")
+    elif is_ollama or is_lmstudio:
+        click.echo("Skipping API key. You can add one later if needed.")
+
+    click.echo(f"\ngac environment setup complete. You can edit {GAC_ENV_PATH} to update values later.")

{gac-1.5.1 → gac-1.5.2}/src/gac/main.py

@@ -59,7 +59,7 @@ def main(
         if model is None:
             handle_error(
                 AIError.model_error(
-                    "No model specified. Please set the GAC_MODEL environment variable or use --model."
+                    "gac init hasn't been run yet. Please run 'gac init' to set up your configuration, then try again."
                 ),
                 exit_program=True,
             )

{gac-1.5.1 → gac-1.5.2}/src/gac/providers/__init__.py

@@ -8,6 +8,7 @@ from .lmstudio import call_lmstudio_api
 from .ollama import call_ollama_api
 from .openai import call_openai_api
 from .openrouter import call_openrouter_api
+from .streamlake import call_streamlake_api
 from .zai import call_zai_api, call_zai_coding_api
 
 __all__ = [
@@ -19,6 +20,7 @@ __all__ = [
     "call_ollama_api",
     "call_openai_api",
     "call_openrouter_api",
+    "call_streamlake_api",
     "call_zai_api",
     "call_zai_coding_api",
 ]

gac-1.5.2/src/gac/providers/streamlake.py

@@ -0,0 +1,47 @@
+"""StreamLake (Vanchin) API provider for gac."""
+
+import os
+
+import httpx
+
+from gac.errors import AIError
+
+
+def call_streamlake_api(model: str, messages: list[dict], temperature: float, max_tokens: int) -> str:
+    """Call StreamLake (Vanchin) chat completions API."""
+    api_key = os.getenv("STREAMLAKE_API_KEY") or os.getenv("VC_API_KEY")
+    if not api_key:
+        raise AIError.model_error(
+            "STREAMLAKE_API_KEY not found in environment variables (VC_API_KEY alias also not set)"
+        )
+
+    url = "https://vanchin.streamlake.ai/api/gateway/v1/endpoints/chat/completions"
+    headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
+
+    data = {
+        "model": model,
+        "messages": messages,
+        "temperature": temperature,
+        "max_tokens": max_tokens,
+    }
+
+    try:
+        response = httpx.post(url, headers=headers, json=data, timeout=120)
+        response.raise_for_status()
+        response_data = response.json()
+        choices = response_data.get("choices")
+        if not choices:
+            raise AIError.model_error("StreamLake API returned no choices")
+
+        message = choices[0].get("message", {})
+        content = message.get("content")
+        if content is None:
+            raise AIError.model_error("StreamLake API returned null content")
+        if content == "":
+            raise AIError.model_error("StreamLake API returned empty content")
+
+        return content
+    except httpx.HTTPStatusError as e:
+        raise AIError.model_error(f"StreamLake API error: {e.response.status_code} - {e.response.text}") from e
+    except Exception as e:  # noqa: BLE001 - convert to AIError
+        raise AIError.model_error(f"Error calling StreamLake API: {str(e)}") from e

gac-1.5.1/src/gac/__init__.py

@@ -1,27 +0,0 @@
-"""Git Auto Commit (gac) - Generate commit messages using AI."""
-
-from gac.__version__ import __version__
-from gac.ai import generate_commit_message
-from gac.git import get_staged_files, push_changes
-from gac.prompt import build_prompt, clean_commit_message
-from gac.providers.anthropic import call_anthropic_api as anthropic_generate
-from gac.providers.cerebras import call_cerebras_api as cerebras_generate
-from gac.providers.groq import call_groq_api as groq_generate
-from gac.providers.ollama import call_ollama_api as ollama_generate
-from gac.providers.openai import call_openai_api as openai_generate
-from gac.providers.openrouter import call_openrouter_api as openrouter_generate
-
-__all__ = [
-    "__version__",
-    "generate_commit_message",
-    "build_prompt",
-    "clean_commit_message",
-    "get_staged_files",
-    "push_changes",
-    "anthropic_generate",
-    "cerebras_generate",
-    "groq_generate",
-    "ollama_generate",
-    "openai_generate",
-    "openrouter_generate",
-]

gac-1.5.1/src/gac/init_cli.py

@@ -1,53 +0,0 @@
-"""CLI for initializing gac configuration interactively."""
-
-from pathlib import Path
-
-import click
-import questionary
-from dotenv import set_key
-
-GAC_ENV_PATH = Path.home() / ".gac.env"
-
-
-@click.command()
-def init() -> None:
-    """Interactively set up $HOME/.gac.env for gac."""
-    click.echo("Welcome to gac initialization!\n")
-    if GAC_ENV_PATH.exists():
-        click.echo(f"$HOME/.gac.env already exists at {GAC_ENV_PATH}. Values will be updated.")
-    else:
-        GAC_ENV_PATH.touch()
-        click.echo(f"Created $HOME/.gac.env at {GAC_ENV_PATH}.")
-
-    providers = [
-        ("Anthropic", "claude-3-5-haiku-latest"),
-        ("Cerebras", "qwen-3-coder-480b"),
-        ("Gemini", "gemini-2.5-flash"),
-        ("Groq", "meta-llama/llama-4-maverick-17b-128e-instruct"),
-        ("LM Studio", "deepseek-r1-distill-qwen-7b"),
-        ("Ollama", "gemma3"),
-        ("OpenAI", "gpt-4.1-mini"),
-        ("OpenRouter", "openrouter/auto"),
-        ("Z.AI", "glm-4.5-air"),
-        ("Z.AI Coding", "glm-4.6"),
-    ]
-    provider_names = [p[0] for p in providers]
-    provider = questionary.select("Select your provider:", choices=provider_names).ask()
-    if not provider:
-        click.echo("Provider selection cancelled. Exiting.")
-        return
-    provider_key = provider.lower().replace(".", "").replace(" ", "-")
-    model_suggestion = dict(providers)[provider]
-    model = questionary.text(f"Enter the model (default: {model_suggestion}):", default=model_suggestion).ask()
-    model_to_save = model.strip() if model.strip() else model_suggestion
-    set_key(str(GAC_ENV_PATH), "GAC_MODEL", f"{provider_key}:{model_to_save}")
-    click.echo(f"Set GAC_MODEL={provider_key}:{model_to_save}")
-
-    api_key = questionary.password("Enter your API key (input hidden, can be set later):").ask()
-    if api_key:
-        # Z.AI and Z.AI Coding both use the same API key
-        api_key_name = "ZAI_API_KEY" if provider_key in ["zai", "zai-coding"] else f"{provider_key.upper()}_API_KEY"
-        set_key(str(GAC_ENV_PATH), api_key_name, api_key)
-        click.echo(f"Set {api_key_name} (hidden)")
-
-    click.echo(f"\ngac environment setup complete. You can edit {GAC_ENV_PATH} to update values later.")