SocaitySDK CLI Reference
The socaity CLI ships with the Python SDK and is what you use to interact with services — log in, install community services, and run quick checks from your terminal.
The CLI is bundled with the Python SDK. Install it with pip — same package as the SDK.
pip install socaity| Command | Purpose | Status |
|---|---|---|
socaity -h | Show CLI usage and available commands. | Coming Soon |
socaity login | Issue a temporary API key and store it locally. | Coming Soon |
socaity --install <name> | Install an unofficial community service into the local SDK. | Coming Soon |
Print the available commands and flags. Always the safest place to start.
socaity package — running socaity -h from your shell does not work today. The commands below describe the shape of the CLI as it is being designed. # Planned usage
socaity -h
socaity --help Issues a temporary API key and stores it on disk, similar to gh auth login or claude login. Removes the need to manage SOCAITY_API_KEY by hand for local development.
socaity login ships, generate an API key from the API Keys page and export it as SOCAITY_API_KEY. # Planned usage — interactive flow, similar to `gh auth login`
socaity loginAdds an unofficial / community service to your local SDK so you can import and call it like any official model. This is the bridge between the public service catalogue and your code.
--install flag is not yet wired up. For now, community services need to be added manually — track progress on github.com/SocAIty/socaity. # Planned usage — install a community service by name
socaity --install some-user/some-serviceWhile the CLI is being built out, every command above has a Python-level equivalent. For most users, the SDK is already enough.
import os
from socaity import face2face
# Authentication — until `socaity login` ships, the SDK reads
# the SOCAITY_API_KEY env var directly.
f2f = face2face(api_key=os.getenv("SOCAITY_API_KEY"))
# Community/unofficial services — until `socaity --install` ships,
# the service manager that syncs official services lives at
# socaity.core.socaity_service_manager.SocaityServiceManager.