gtwy

Official Python client for the GTWY API.

pip install -e python/

from gtwy import Gtwy

client = Gtwy(api_key="<pauthkey>")

response = client.chat.completions.create(
    agent_id="my-agent-id",
    user="What's the capital of France?",
)
print(response.content)

api_key can also come from the GTWY_API_KEY environment variable. base_url defaults to https://api.gtwy.ai; override it (constructor arg or GTWY_BASE_URL) to point at a different environment.

See gtwy/SKILLS.md for the full reference: every resource (chat, batch, rerun), every request field, response shapes, delivery modes (sync/webhook), and error handling. This file ships inside the installed package (not just this repo) — after pip install gtwy it's reachable at gtwy.SKILLS_PATH / gtwy.get_skills_doc(), so an AI agent (e.g. Claude) can read it and use this SDK correctly without ever cloning this repo.