GatherSDK

Connect Google ADK agents to Gather.is workspaces.

Installation

pip install gathersdk google-adk

Quick Start

1. Initialize your project

mkdir my-agents && cd my-agents
python -m venv .venv && source .venv/bin/activate
pip install gathersdk google-adk
gathersdk init --name hello_agent

2. Get your config

Go to app.gather.is
Create or open a workspace
Click workspace dropdown → SDK Settings
Download gather.config.json and replace the placeholder

3. Set your API key

cp .env.example .env
# Edit .env and add your Google API key from https://aistudio.google.com/apikey

4. Run

source .env && gathersdk serve

The SDK automatically starts adk web if not already running.

5. Chat with your agent

Go to app.gather.is and type @hello_agent hello!

Commands

# Initialize a new agent project
gathersdk init --name my_agent

# Start the SDK (auto-starts ADK web server)
gathersdk serve

# Start without auto-starting ADK
gathersdk serve --no-auto-adk

# Discover agents without connecting
gathersdk discover

# Verbose logging
gathersdk -v serve

Project Structure

my-agents/
├── gather.config.json   # From app.gather.is SDK Settings
├── .env                 # GOOGLE_API_KEY=your_key
└── hello_agent/
    ├── __init__.py      # from .agent import root_agent
    └── agent.py         # root_agent = Agent(...)

Agent Code

# hello_agent/agent.py
from google.adk import Agent

root_agent = Agent(
    name="hello_agent",
    model="gemini-2.5-flash",
    instruction="You are a helpful assistant."
)

# hello_agent/__init__.py
from .agent import root_agent

Debugging

The ADK debug UI is available at http://localhost:8000 when running. View:

Session history and state
Message flow and events
Tool calls and responses

Metadata

Release files for gathersdk 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gathersdk 0.3.2
File	Size	Uploaded
gathersdk-0.3.2.tar.gz	16.7 kB	Jan 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for gathersdk 0.3.2
File	Interpreter	ABI	Platform	Reset
gathersdk-0.3.2-py3-none-any.whl 19.2 kB Jan 26, 2026	Python 3	none	any	Details

Total release size: 35.9 kB

Release files / gathersdk-0.3.2.tar.gz

Download URL	gathersdk-0.3.2.tar.gz
Size	16.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`a98ed40bdb90b36e96771fb4efc6ccf485b7ebf530d7ee5dc005512ad4915363`
BLAKE2b-256 checksum How to use checksums	`be24828a07f6e046a78b4641b58f988de621d1457d39e7810d2804f3c2a826a9`
Upload date	Jan 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.9`

Release files / gathersdk-0.3.2-py3-none-any.whl

Download URL	gathersdk-0.3.2-py3-none-any.whl
Size	19.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b6d400c9badb29496687a7df955eef5ea14c00cfa2f581b6e1819d07ac275756`
BLAKE2b-256 checksum How to use checksums	`de2328186aa4237173ab31dbee9fccc486f1b24b66cde176ee29268cfb89abec`
Upload date	Jan 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.9`