scale-gp

What it is and what it does

scale-gp is the official Python client for Scale's SGP Client REST API, generated using Stainless. It provides both synchronous and asynchronous interfaces to interact with knowledge bases, models, and other API resources. The library includes full type hints for all request parameters and response objects, built on httpx for HTTP transport and pydantic for response validation.

The package supports common REST patterns: paginated list operations with automatic page fetching, streaming responses via Server-Sent Events, nested typed parameters, and comprehensive error handling. It requires Python 3.9+ and has six runtime dependencies. However, the description explicitly warns this is the legacy v4 API SDK; Scale recommends using sgp-python-beta for the latest v5 API.

Use it for:

• Build knowledge base management tools that create, list, and configure embedding models via the SGP API
• Implement chat completion endpoints with streaming support for real-time response handling
• Develop async applications that need concurrent API calls without blocking
• Integrate SGP services into typed Python applications with IDE autocomplete and type checking

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python client library for the SGP Client REST API, providing synchronous and asynchronous access with full type definitions and support for streaming responses.

Yes, but with conditions: install only if you are actively using the v4 SGP API and cannot migrate to v5. The package is actively maintained, has low install friction, permissive licensing, and no known vulnerabilities. However, the explicit legacy status and recommendation to use sgp-python-beta means this is not the forward path—evaluate whether v5 is available for your use case first.

Install

scale-gp on PyPI

pip install scale-gp

uv add scale-gp

poetry add scale-gp

Installing scale-gp

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained as of the latest release; however, this is explicitly a legacy v4 API SDK with a newer v5 replacement available.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions, requiring only license and copyright notice retention.

Quickstart

import os
from scale_gp import SGPClient

client = SGPClient(api_key=os.environ.get("SGP_API_KEY"))
response = client.knowledge_bases.create(
    embedding_config={"model_deployment_id": "id", "type": "models_api"},
    knowledge_base_name="my_kb"
)
print(response.knowledge_base_id)

Requires Python 3.9 or later; API key must be provided via SGP_API_KEY environment variable or constructor argument.

Verify before relying

• Whether v4 API will continue to receive updates or is in maintenance-only mode
• Performance characteristics of async client with httpx versus alternative HTTP backends
• Stability guarantees for the 0.1.0a62 pre-release version

Package facts

Evidence: scale_gp-0.1.0a62-py3-none-any.whl

Tags

More Python Modules packages