All notable changes to this project are documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Nothing yet.
0.1.0 - 2026-09-02
Initial release, targeting tensic.ai server 1.6 and newer.
Tensic/AsyncTensicclients with identical APIs: env-based configuration (TENSIC_URL,TENSIC_API_KEY), API-key or username/password (Tensic.login, TOTP aware) authentication,Tensic.ldap_login()/AsyncTensic.ldap_login()for instances with LDAP authentication enabled (POST /ldap, the same cookie session aslogin(), no TOTP step), timeouts, retries with back-off andRetry-Aftersupport,with_options(), bring-your-ownhttpxclient,TENSIC_LOG=debuglogging.client.chat:send,stream(typed SSE events, resume vialast_event_id, error frames raised asChatStreamError),stop,upload_attachment,get_asset,conversation()helper with turn history, automaticIdempotency-Keyon non-streaming turns.client.knowledge: text/URL/file/bulk ingestion, semantic search, source listing, chunk inspection, deletion, reset, sync and re-embed jobs.client.projectswith sub-resources: prompts, secrets, routines, widgets, logs, conversations, analytics, evals, memory, comments, guards, custom tools, webhooks, integrations; plusiter()auto-paging andfind(name).client.teams,client.users(withapi_keys),client.llms,client.embeddings,client.tools,client.statistics,client.templates,client.image,client.audio,client.settings,client.classifiers,client.image_generators,client.speech_to_text,client.invitations,client.examples,client.news,client.search(),client.whoami(),client.version(), andclient.health(probe="ready"|"live")addressing either container probe route (GET /health/ready,GET /health/live).client.direct: OpenAI-compatible chat completions (sync/async, streamingChatCompletionStream), completions, embeddings, models, image generation, audio transcription/translation, moderations, plusclient.openai_base_urlfor the officialopenaipackage.WidgetClient/AsyncWidgetClientfor widget-key access (config,chat,stream).- Typed exception hierarchy (
tensicai.errors) parsing the tensic error envelope, legacydetailshapes and the OpenAI error shape, exposingrequest_id,retry_afterand rate limit headers. - Lenient dataclass models under
tensicai.types(unknown fields kept in.extra),Page/ProjectsPagepagination helpers,py.typed. - The request-side type aliases used by the SDK's own signatures are public, so typed wrapper
code never reaches into a private module:
FileInput,FileContent,AttachmentInput,Timeout,TimeoutOrNotGiven,NotGiven,NotGivenOrandProbeare exported fromtensicaiandtensicai.types, and the wire-value literal aliases (Splitter,IngestMethod,Privacy,TemplateVisibility) each live in exactly one domain type module. image=is validated client-side: astris a base64 payload or anhttp(s)/data:URL and is never read from disk, so a filename raisesValueErrorpointing atPath(...)before any request rather than sending the model a name it cannot see.bytesand apathlib.Pathare base64-encoded for you.client.image.generate(image=...)is stricter still — that endpoint decodes rather than fetches, so it takes base64, adata:URL,bytesor aPath, but not anhttp(s)URL.- Runnable examples under
examples/, GitHub Actions CI (Python 3.10–3.14) and a PyPI Trusted Publishing release workflow.
- Two declared runtime dependencies:
httpx>=0.25,<1andanyio>=3.5.anyiois imported directly by the async client (retry back-off sleeps, threaded file reads forPath/file-object uploads) and is declared in its own right rather than relied on transitively through httpx/httpcore. - PyPI metadata:
authorsnames team.blue (pedro.dias@team.blue) with the individual undermaintainers; the license is the PEP 639 expressionApache-2.0with no deprecatedLicense ::classifier;Programming Language :: Python :: 3 :: Onlyis declared. The project URLs areDocumentation(the README),Repository,Issues,Architecture(docs/INTERNALS.md, the contributor guide) andChangelog— every link points at a host we control, never at the parkedtensic.clouddomain. - The sdist ships
.github/andMakefilealongsidetests/, so the test suite it carries passes from an extracted sdist and themaketargets CONTRIBUTING.md documents run there. - CI and the release workflow install with
uv sync --locked, so auv.lockthat no longer matchespyproject.tomlfails the run instead of being silently re-resolved. publish.ymlruns ruff, mypy and the full test suite before building, so a tag push cannot upload to PyPI ahead of (or despite) a red CI run.