How to Build & Register a Production AI Agent

import os, sys, subprocess
from google import genai
from google.genai import types

client = genai.Client(api_key=os.environ.get("GEMINI_API_KEY"))

# 1. Deterministic Tool Layer (Outside the LLM)
def inspect_git_diff() -> str:
    """Returns uncommitted git changes in the current workspace."""
    out = subprocess.getoutput("git diff")
    return out if out.strip() else "Workspace is clean. No diff detected."

def run_tests() -> str:
    """Executes the test suite and returns the test summary."""
    return subprocess.getoutput("pytest -q")

tools = [inspect_git_diff, run_tests]

# 2. Strict Persona & Privilege Bounds
config = types.GenerateContentConfig(
    system_instruction=(
        "You are GitFixer, an autonomous engineering agent. "
        "Inspect the git diff, run local unit tests, and propose concise fixes. "
        "Never run destructive commands like 'git reset --hard'."
    ),
    tools=tools,
    temperature=0.2
)

# 3. Perception-Action ReAct Loop
def run_agent(goal: str):
    print(f"🤖 [GitFixer Started] Goal: {goal}")
    chat = client.chats.create(model="gemini-2.5-flash", config=config)
    response = chat.send_message(goal)
    print("\n" + response.text)

if __name__ == "__main__":
    if not os.environ.get("GEMINI_API_KEY"):
        print("❌ Please run: export GEMINI_API_KEY='your_key'")
        sys.exit(1)
    run_agent("Inspect the workspace diff, run tests, and report status.")

{
  "id": "git-fixer",
  "name": "GitFixer AI",
  "slug": "git-fixer",
  "tagline": "Autonomous agent that inspects uncommitted diffs, runs test suites, and crafts clean commits.",
  "category": "coding",
  "categoryLabel": "Coding & SWE",
  "framework": "standalone",
  "frameworkLabel": "Python / Standalone",
  "author": "YourGitHubUsername",
  "github": "https://github.com/YourUsername/git-fixer",
  "stars": "100+",
  "license": "MIT",
  "verified": true,
  "featured": false,
  "recommendedModels": [
    "gemini-2.5-flash",
    "claude-3-5-sonnet"
  ],
  "toolsRequired": [
    "Git CLI",
    "Pytest Runner"
  ],
  "tags": [
    "git",
    "swe",
    "testing",
    "autonomous"
  ],
  "description": "GitFixer examines unstaged and staged changes, runs local test suites, and crafts clean conventional commits.",
  "quickstart": {
    "type": "Python Pip",
    "command": "pip install git-fixer && git-fixer review"
  }
}