Python SDK

Python

Carry the same trust-first flow into notebooks and scripts

Goal: keep CLI and SDK behavior aligned so automation uses the same search and download semantics as the web UI.

Notebook shell

Public-first commands

Use --json when the result needs to feed another notebook cell or script step.

!rawctx search "semantic model" --sort downloads --json
!rawctx info @scope/name --json
!rawctx snapshot-download @scope/name --json

Python SDK

Sync and async clients

Use the convenience API for straightforward automation, or the async client when the caller already owns the event loop.

import asyncio
import rawctx

packages = rawctx.search("semantic model", sort="downloads", registry="https://api.rawctx.dev")
package = rawctx.info("@scope/name", registry="https://api.rawctx.dev")
snapshot_dir = rawctx.snapshot_download("@scope/name", registry="https://api.rawctx.dev")

async def main():
    async with rawctx.AsyncRawctxClient(registry="https://api.rawctx.dev") as client:
        return await client.search("semantic model", sort="recent")

asyncio.run(main())