Metadata-Version: 2.4
Name: gtwy-sdk
Version: 0.3.0
Summary: Official Python SDK for the GTWY API — build and call agentic AI, RAG, and LLM-powered agents
Author: GTWY
License: MIT
Project-URL: Homepage, https://gtwy.ai
Keywords: gtwy,ai,llm,agents,agentic ai,rag,chatbot,sdk,api client
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests<3,>=2.25
Dynamic: license-file

# gtwy-sdk

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

```bash
pip install gtwy-sdk
```

```python
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](./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

```bash
cd python
pip install -e .
```
