socaity-cli

The command line for the socaity.ai platform: login, catalog browsing, socaity run, and APIPod deployment tooling. One socaity command, shared by the socaity SDK and APIPod.

The package is deliberately small: httpx2 and socaity-schemas are the only dependencies. Commands that need more (SDK run, container builds) delegate to the socaity or apipod package and tell you what to install when it is missing.

Install

pip install socaity-cli

You get socaity-cli as part of pip install socaity or pip install apipod as well.

Commands

Use --project-dir DIR with scan/build/start/deploy to point at a service project directory (e.g. socaity --project-dir simple_test_service deploy serverless-runpod --yes).

Configuration

Using it as a library

socaity and apipod build on the same primitives this package exposes:

from socaity_cli import SocaityBackendClient, get_api_key, requires

SocaityBackendClient covers catalog reads, search, and connectors (inspect_connector, register_connector, change_connector_credential, disconnect_connector_credential). The first three stream server-sent events to on_event (progress, authorize); inspect writes no catalog row. Catalog rows are Service models: details[] holds the spec plus a nested deployment or connector for the URL. details[0] is the binding unpinned calls use. Pass it as details_id to pin the spec. Resume a deploy with deployment_id (that binding's deployment.id). Connectors are services with kind == "connector". requires("apipod") guards a function behind an optional package with a friendly install hint instead of an ImportError traceback.