giga-sdk 1.0.0

Giga SDK and CLI — agent building framework with command-line tools

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}")