Skillforge Python Client

Official, typed Python client for the Skillforge HTTP API. The package is generated from Skillforge's versioned OpenAPI contract and released with the matching Skillforge version.

Installation

With uv:

uv add skillforge-client

Or with pip:

python -m pip install skillforge-client

Quick start

Use AuthenticatedClient for endpoints protected by a Skillforge bearer token:

import os

from skillforge_client import AuthenticatedClient

client = AuthenticatedClient(
    base_url=os.environ["SKILLFORGE_URL"],
    token=os.environ["SKILLFORGE_TOKEN"],
)

Endpoint functions are grouped by their OpenAPI tag. For example, the liveness endpoint can be called synchronously:

import os

from skillforge_client import Client
from skillforge_client.api.system import system_liveness_check

with Client(base_url=os.environ["SKILLFORGE_URL"]) as client:
    health = system_liveness_check.sync(client=client)

if health is not None:
    print(health.status.value)

Every generated endpoint module provides four variants:

• sync: blocking call returning the parsed response or None
• sync_detailed: blocking call returning status, headers, content, and the parsed response
• asyncio: asynchronous call returning the parsed response or None
• asyncio_detailed: asynchronous call returning the detailed response

Generated request and response models are available from skillforge_client.models.

Versioning and source

Client versions follow Skillforge releases. This package was generated from the openapi.json contract for Skillforge v0.4.0; generated source is not maintained by hand.

• Skillforge repository
• Issue tracker