Skip to content

Release/v1.0.0 sdk realignment#6

Merged
dewitt4 merged 6 commits into
mainfrom
release/v1.0.0-sdk-realignment
Jul 14, 2026
Merged

Release/v1.0.0 sdk realignment#6
dewitt4 merged 6 commits into
mainfrom
release/v1.0.0-sdk-realignment

Conversation

@dewitt4

@dewitt4 dewitt4 commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

This pull request introduces the first stable, production release of the SDK, with a major rebranding and several breaking changes, new features, and fixes. The SDK is now named whiteboxxai (double "x"), and all references, import paths, and configuration variables have been updated accordingly. The codebase structure has been simplified, new features have been added to the ModelMonitor, and various documentation and example code have been updated to match the new branding and API. This release also fixes several integration and documentation issues and adds support for Python 3.12.

Rebranding and Breaking Changes

  • Rebranded the SDK from whiteboxai/whiteboxai-sdk to whiteboxxai/whitebox-xai-sdk (double "x"), updating all import paths, install commands, and environment variables (e.g., EXPLAINAI_*WHITEBOXXAI_*). The API base URL is changed to whiteboxxai.com. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16] [17] [18] [19]
  • Changed the package structure from src/whiteboxai/ to a flat whiteboxxai/ layout at the repository root, removed setup.py, and now use pyproject.toml as the single build configuration. [1] [2]
  • Updated the test and lint workflow to use the new package path and added Python 3.12 to the test matrix. [1] [2] [3]

New Features and Improvements

  • Added local buffering and batch flushing to ModelMonitor, new convenience methods, and improved error handling with structured metadata in SDK exceptions. [1] [2]
  • Added and documented support for offline mode, privacy filters, local caching, and new integrations. [1] [2] [3]

Documentation and Example Updates

  • Updated README.md, code samples, and guides to use the new package name, environment variables, and install commands. Fixed incorrect class names, import paths, and added documentation for new features. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15]
  • Added a LICENSE file matching the declared MIT license.

Bug Fixes

  • Fixed import-time crashes for users without PyTorch or TensorFlow, and corrected various documentation errors.

Miscellaneous

  • Updated the copyright to the WhiteBoxXAI Team.
  • Updated the changelog to document all major changes for this release.

This release contains several breaking changes—users must update their import paths, environment variables, and install commands to migrate.

dewitt4 and others added 2 commits July 14, 2026 15:56
Replaces the stale whiteboxai/whiteboxai.io (single "x") branding and
src/ layout with the fixed, canonical whiteboxxai/whiteboxxai.com
content from the whitebox-xai-azure monorepo's sdk/ directory:

- Flat whiteboxxai/ package layout (was src/whiteboxai/); dropped the
  legacy setup.py in favor of pyproject.toml as the single build config.
- Fixed an import-time crash affecting anyone without PyTorch/TensorFlow
  installed, corrected ModelMonitor's resource API calls, added
  structured exception metadata, and added buffering/context-manager/
  drift-report/alert convenience methods (see CHANGELOG.md [1.0.0] for
  the full list).
- Preserved and rebranded (rather than discarded) this repo's existing
  release scaffolding: CHANGELOG.md (added [1.0.0] and a reconstructed
  [0.2.1] entry), the mkdocs documentation site, and the tests/
  unit+integration structure -- now populated with the repaired test
  suite (168 passed, 2 skipped locally, one for a missing sklearn
  install, one for a not-yet-implemented metrics resource).
- Updated test.yml for the new layout and .env.example/MANIFEST.in for
  accuracy. publish.yml needs no changes (package-name-agnostic, OIDC
  trusted publishing).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@dewitt4 dewitt4 self-assigned this Jul 14, 2026
@dewitt4 dewitt4 added documentation Improvements or additions to documentation enhancement New feature or request labels Jul 14, 2026
dewitt4 and others added 4 commits July 14, 2026 16:20
Fixes Code Quality Checks (black --check, isort --check-only), which
was never run against this content before the previous commit.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Removes ~70 flake8 findings so Code Quality Checks passes fully:
unused imports (F401), unused local variables (F841), f-strings
without placeholders (F541), a redefined-but-unused pipeline import
(F811) in the transformers integration, and two E402 import-order
findings in tensorflow.py (noqa'd — the imports genuinely must follow
the TORCH_AVAILABLE-style try/except guard).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
… build

The guide's embedded example content linked to files from the main
platform repo's structure (DEVELOPMENT.md, CONTRIBUTING.md, a proposed
docs/ layout) that don't exist in this repo, failing `mkdocs build
--strict`. De-linked them to plain text since they're illustrative
references, not real navigable docs here.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@dewitt4
dewitt4 merged commit b22223a into main Jul 14, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant