gtwy-sdk

Official Python client for the GTWY API — build and call agentic AI, RAG, and LLM-powered agents.

pip install gtwy-sdk

from gtwy import Gtwy

client = Gtwy(auth_key="<authKey>")

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

auth_key is the key you get from the GTWY platform (labeled authkey there). It can also come from the GTWY_AUTH_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-sdk 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.

Development

cd python
pip install -e .