gia-sdk 0.1.0

Python SDK and CLI for Gia Cloud

Gia SDK

Gia is a trainable semantic graph database. The gia-sdk Python distribution installs both the public Python SDK and the gia command-line interface used to create, apply, query, benchmark, and inspect Gia-backed application projects.

pip install gia-sdk
gia --help

Application code imports the SDK from the gia package:

from gia import Gia

gia = Gia.from_env()
response = gia.query_response(
    "billing invoice webhook retry ticket",
    target="ticket",
    schema_name="project_management",
    schema_version="v2",
    profile="linear_ticket_search",
    profile_version="v1",
    persist_trace=True,
)
print(response.results)
print(response.trace_id)

The CLI uses public uppercase environment variables in application projects:

GIA_API_URL=https://api.gia.cloud
GIA_API_KEY=gia_development_or_production_environment_key
GIA_TIMEOUT_SECONDS=30

For the cloud-first project workflow, sign in, create or link a project, apply the manifest, create an app dotenv, and then use the same dotenv from both CLI and SDK code:

gia login
gia project create . --template project-management --name "Project Management" --dotenv .env.local

set -a
. ./.env.local
set +a

gia query "billing invoice webhook retry ticket" \
  --target ticket \
  --schema-name project_management \
  --schema-version v2 \
  --profile linear_ticket_search \
  --profile-version v1 \
  --persist-trace

More complete operational guidance lives in docs/guides/gia-bootstrap.md.