Quickstart

pip install gitagent

mkdir my-agent && cd my-agent
git init
gitagent init

my-agent/
├── agent.yaml
├── skills/
│   └── hello.py
├── hooks/
└── flows/

name: my-agent
version: "1.0.0"
description: "My first GitAgent"

model:
  provider: openai
  name: gpt-4o
  temperature: 0.0

entrypoint: skills/hello.py

memory:
  enabled: false

from gitagent import skill

@skill(
    name="greet",
    description="Greet the user by name"
)
def greet(name: str) -> str:
    """Return a personalized greeting."""
    return f"Hello, {name}! I'm your GitAgent."

export OPENAI_API_KEY=sk-...

gitagent run "Please greet Alice"

> Running my-agent
> Calling skill: greet(name="Alice")
> Hello, Alice! I'm your GitAgent.

from gitagent import skill
import httpx

@skill(
    name="get_weather",
    description="Get the current weather for a city"
)
def get_weather(city: str) -> dict:
    """Fetch current weather data for a city."""
    response = httpx.get(
        "https://wttr.in/{city}?format=j1".format(city=city)
    )
    data = response.json()
    return {
        "city": city,
        "temp_c": data["current_condition"][0]["temp_C"],
        "description": data["current_condition"][0]["weatherDesc"][0]["value"]
    }

gitagent run "What's the weather in London?"

git add .
git commit -m "feat: initial agent with weather skill"