Python

codespar 0.11.0 on PyPI; 0.11.0 on the main branch of codespar-core.

pip install codespar

Two clients over the same backend: CodeSpar is synchronous (scripts, notebooks, Flask and Django views) and AsyncCodeSpar is asyncio (FastAPI, LangChain, anything already on an event loop). Both return a session with the same method names; the async one returns coroutines.

from codespar import CodeSpar

cs = CodeSpar(api_key="csk_test_0000")
session = cs.create("user_0000", preset="brazilian")
try:
    result = session.send("Charge R$150 via Pix and issue the NF-e")
    print(result.message)
finally:
    session.close()
    cs.close()

from codespar import AsyncCodeSpar

async with AsyncCodeSpar(api_key="csk_test_0000") as cs:
    session = await cs.create("user_0000", preset="brazilian")
    async for event in session.send_stream("Charge R$150 via Pix"):
        if event.type == "assistant_text":
            print(event.content, end="")
    await session.close()

Three things differ from the TypeScript package on purpose, and the tables below say which names exist on each side:

• Names are snake_case. paymentStatusStream is payment_status_stream; findTools is find_tools. A TypeScript page that mentions a Python name labels it as such.
• Timeouts are in seconds, following httpx. timeout=30 is thirty seconds here and thirty milliseconds in TypeScript; do not copy a number between the two.
• Errors are a hierarchy under CodeSparError. ApiError carries status, code and body like CodesparApiError does; ConfigError, NotConnectedError and StreamError have no TypeScript counterpart.

Streams accept on_update= (sync or async callable) and timeout=; the promise-style signal of the TypeScript SDK has no equivalent, cancel the task instead. The Python stream relies on the httpx read timeout, which any incoming byte resets; the TypeScript one resets only on a complete SSE frame. Both are documented liveness models and are deliberately not unified.

The codespar.mandate module (verify_mandate_token, decode_mandate_token) matches the @codespar/sdk/mandate subpath: offline V3 mandate verification with no API call.

Session methods

One row per method of the TypeScript Session. The Python column is the signature as written in _sync_client.py; AsyncSession has the same names as coroutines.

Client, functions and errors

Only in Python

• CodeSparError (Exception)
• ConfigError (CodeSparError)
• NotConnectedError (CodeSparError)
• StreamError (CodeSparError)
• session.info (property)
• await AsyncCodeSpar.aclose() (and CodeSpar.close()): the client owns the HTTP transport and must be closed