gas-client 0.1.0

Python SDK for Geospatial Agentic Services (GAS).

GAS Client

Python SDK for Geospatial Agentic Services (GAS).

This package contains only the lightweight client layer. It does not install the GAS server, Flask, GeoPandas, Rasterio, PySAL, or other geospatial runtime dependencies.

Install

Install from the package folder during development:

cd D:\GAS\packages\gas-client
python -m pip install -e .

After publication:

python -m pip install gas-client

Quick Start

from gas_client import GasClient

client = GasClient(
    "https://your-gas-server.com",
    openai_api_key="YOUR_OPENAI_API_KEY",
)

print(client.list_agents())

agent = client.agent("geospatial_data_retrieval_agent")

result = agent.execute_task(
    "Download Pennsylvania county boundaries from Census Bureau.",
    mode="sync",
)

client.print_task_summary(result)

Streaming Tasks

for event in agent.execute_task(
    "Download Pennsylvania county boundaries from Census Bureau.",
    mode="stream",
):
    client.print_stream_event(event)
    if event.get("event") == "task_result":
        result = event.get("payload")

client.print_task_summary(result)

Canonical GAS Request Body

request_body = client.build_execute_task_request(
    "Create an interactive web map.",
    mode="stream",
    input_datasets=[
        "https://example.com/counties.geojson",
    ],
    artifact_delivery="URL",
    credentials={
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY",
    },
)

for event in client.agent("interactive_mapping_agent").execute_task_request(request_body):
    client.print_stream_event(event)

Public API

from gas_client import (
    GASClient,
    GasAgentClient,
    GasClient,
    GasClientError,
    GasTaskTimeoutError,
)

Important methods:

• get_capabilities()
• list_agents()
• describe_agent(agent_id)
• agent(agent_id)
• execute_task(agent_id, instructions, mode="sync")
• execute_task_request(agent_id, request_body)
• get_task_status(agent_id, task_id)
• get_task_result(agent_id, task_id)
• wait_for_task(agent_id, task_id)
• cancel_task(agent_id, task_id)
• encode_dataset_file(path)
• print_stream_event(event)
• print_task_summary(result)

Publishing Checklist

Before publishing publicly:

• Confirm the final package name on PyPI.
• Update version in pyproject.toml.
• Sync the package copy from the repository root if D:\GAS\gas_client changed.
• Run client tests from the repository root.
• Build and inspect the package.

cd D:\GAS
.\packages\gas-client\sync_from_repo.ps1
.\.venv\Scripts\python.exe -m pytest tests\test_gas_client.py

cd D:\GAS\packages\gas-client
python -m build
python -m twine check dist/*

Upload only when ready:

python -m twine upload dist/*