synapsex-platform 0.1.0

SynapseX Python SDK - Deploy and manage AI agents

SynapseX Python SDK

Python SDK for the SynapseX AI platform.

It provides LLMClient, an OpenAI-wire-compatible chat client that talks only to the public SynapseX edge (https://platform.synapsex.ai/api/v1) using a per-customer platform key (sk-synapsex-...).

Installation

pip install synapsex

Usage

from synapsex import LLMClient

# api_key falls back to the SYNAPSEX_API_KEY environment variable.
client = LLMClient(api_key="sk-synapsex-...")

resp = client.chat_completions(
    model="synapsex-nexus-v2",
    messages=[{"role": "user", "content": "Hello, world!"}],
)
print(resp["choices"][0]["message"]["content"])

Streaming:

stream = client.chat_completions(
    model="synapsex-nexus-v2",
    messages=[{"role": "user", "content": "Count from 1 to 5."}],
    stream=True,
)
for chunk in stream:
    for choice in chunk.get("choices", []):
        piece = choice.get("delta", {}).get("content")
        if piece:
            print(piece, end="", flush=True)

Because the wire format is OpenAI-compatible, you can equivalently point the stock openai SDK at the same base URL:

from openai import OpenAI

client = OpenAI(api_key="sk-synapsex-...", base_url="https://platform.synapsex.ai/api/v1")

Errors

Requests raise typed exceptions that subclass SynapseXError: AuthenticationError (401), InsufficientCreditsError (402), PermissionDeniedError (403), RateLimitError (429), and APIError for other non-2xx responses.

Documentation

See https://docs.synapsex.ai.

License

MIT