feat: make SDK local-first and remove platform-only surfaces#720
Merged
Conversation
Switch default startup behavior to LOCAL mode, keep CLIENT as explicit remote mode, and remove unsupported platform-era endpoints plus public OpenAPI model generation artifacts for the major release. Made-with: Cursor
Drop users/me client and local route support, remove CurrentUser and UserPlan domain models, and tighten tooling docs wording to match SDK-owned model maintenance. Made-with: Cursor
Remove remaining platform-era client entrypoints that are not backed by the SDK local runtime API, keeping the public SDK surface aligned with supported endpoints. Made-with: Cursor
Reduce domain.py to models transitively required by the currently supported SDK endpoints and remove remaining platform-era account, billing, notification, artifact, and assistant model surface. Made-with: Cursor
Drop the unsupported computes client surface, remove the local /computes stub endpoint, and remove the obsolete ComputeListItem domain model to keep the SDK API runtime-only. Made-with: Cursor
Drop API key and bearer-token support, remove assistant/user-org/visibility/compute metadata from the SDK domain and endpoints, prioritize local-first examples, and remove the legacy tools folder. Made-with: Cursor
Drop connector, generator, and synthetic dataset usage stat models and fields, including no_of_threads and related no_of_* counters, and align list docstrings with the reduced runtime surface. Made-with: Cursor
Drop sort_by query support from connector, generator, and synthetic dataset list APIs and remove remaining NO_OF_* sort-related surface now that listing is recency-only. Made-with: Cursor
Drop the disabled client-mode E2E workflow job and remove outdated api_domain filters that referenced removed Share/LiteLlm/DataLlm/UsageReport surfaces. Made-with: Cursor
Update initialization examples to require explicit base_url for client mode and remove remaining mention of MOSTLY_BASE_URL environment configuration. Made-with: Cursor
Drop /about and /models endpoint support from local routes and client helpers, remove the remaining AboutService domain model, and update docs/tests accordingly. Made-with: Cursor
Drop MOSTLY_LOCAL-based mode selection so SDK mode is configured only through explicit constructor arguments. Made-with: Cursor
mplatzer
changed the title
mplatzer
changed the title
Drop short-lived file token arguments from local file/log download endpoints so the SDK API no longer exposes legacy platform-era token plumbing. Made-with: Cursor
Fix Docker runtime entrypoint after tools removal, refresh local server description text, and update project homepage plus stale build excludes. Made-with: Cursor
Make docs and tutorials local-first by removing SDV comparison notebooks, dropping support contact links, and cleaning external blog references while updating README install/quick-start ordering. Made-with: Cursor
Update Quick Start to show only LOCAL mode setup and use uv pip install for the primary install command. Made-with: Cursor
Remove redundant wording in the Quick Start local install sentence while keeping the local-first guidance intact. Made-with: Cursor
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
LOCALthe default SDK mode and keepCLIENTas an explicit optional remote modeTest plan
uv run pytest tests/client/unit/test_base.py tests/client/unit/test_utils.pyuv run pytest tests/test_domain.pyuv run pytest tests/_local/unit/test_server.pyuv run python -m compileall mostlyai/sdkMade with Cursor