Giga SDK

Agent building framework and CLI for the Giga platform.

Installation

pip install giga-sdk

Requirements

Python >= 3.12

CLI

After installation, the giga CLI is available:

giga --help
giga login
giga validate
giga whoami

Note: the giga CLI is currently only supported inside a Giga repository with a valid giga.config.json.

SDK

Create an agent, give it a typed variable store, and register hooks and code blocks with decorators:

from pydantic import BaseModel
from giga import Agent, CodeBlockResult

class Variables(BaseModel):
    guest_name: str | None = None

agent = Agent(name="my-agent", store=Variables)

@agent.initialization
def init(initialization_values, store):
    return {"guest_name": "Unknown"}

@agent.code_block(description="Greet the user")
def greet(name: str, store) -> CodeBlockResult:
    return CodeBlockResult(
        message=f"Hello {name}!",
        store_updates={"guest_name": name},
    )

You can also define API actions and post-conversation hooks:

from giga import api
from giga.types import ResolutionResult, Analysis

get_user = api(
    name="get_user",
    description="Get user info",
    method="GET",
    url="https://api.example.com/users/{id}",
)

@agent.post_conversation
def post_conversation(resolution_result: ResolutionResult, analysis: Analysis):
    if resolution_result.resolution_status == "resolved":
        print(f"Resolved: {analysis.summary}")

Development Status
- 5 - Production/Stable
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3
- Python :: 3.12

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

giga_sdk-1.5.0.tar.gz (386.9 kB view details)

Uploaded Jul 30, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

giga_sdk-1.5.0-py3-none-any.whl (303.5 kB view details)

Uploaded Jul 30, 2026 Python 3

File details

Details for the file giga_sdk-1.5.0.tar.gz.

File metadata

Download URL: giga_sdk-1.5.0.tar.gz
Upload date: Jul 30, 2026
Size: 386.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for giga_sdk-1.5.0.tar.gz
Algorithm	Hash digest
SHA256	`d70e919cee3b3900c40021552464be50326a8478ff4a771088675a0bb6db32cb`
MD5	`8673f99c349cea0894b3a069c579be5c`
BLAKE2b-256	`9f9457d84f7f369b504871d23a198b1b37c106475c7c594d2120d9ce8dd09392`

See more details on using hashes here.

Provenance

The following attestation bundles were made for giga_sdk-1.5.0.tar.gz:

Publisher: pypi-release.yml on Giga-customers/giga-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: giga_sdk-1.5.0.tar.gz
- Subject digest: d70e919cee3b3900c40021552464be50326a8478ff4a771088675a0bb6db32cb
- Sigstore transparency entry: 2293963076
- Sigstore integration time: Jul 30, 2026
Source repository:
- Permalink: Giga-customers/giga-sdk@c68d198e8ceb62900fc9d4e48aaf3dc74fe1d0cd
- Branch / Tag: refs/tags/v1.5.0
- Owner: https://github.com/Giga-customers
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pypi-release.yml@c68d198e8ceb62900fc9d4e48aaf3dc74fe1d0cd
- Trigger Event: push