dstack 0.21.0__tar.gz → 0.21.2__tar.gz

dstack-0.21.2/.justfile

@@ -0,0 +1,33 @@
+# Root justfile
+#
+# This justfile serves as the main entry point to recipes from different components.
+#
+# Run `just` to see all available commands.
+#
+# Components:
+# * runner/.justfile – Building and uploading dstack runner and shim
+# * frontend/.justfile – Building and running the frontend
+# * mkdocs/.justfile – Building and previewing the docs site
+# * website/.justfile – Building and previewing the React landing page
+# * .tox.justfile – Running Python tests via tox
+
+set minimum-version := '1.55.0'
+
+[doc("Building and uploading dstack runner and shim")]
+mod runner "runner/.justfile"
+
+[doc("Running Python tests via tox")]
+mod tox ".tox.justfile"
+
+set allow-duplicate-recipes
+
+import "frontend/.justfile"
+
+import "mkdocs/.justfile"
+
+import "website/.justfile"
+
+[default]
+[private]
+default:
+    @just --list --list-submodules --unsorted

dstack-0.21.2/AGENTS.md

@@ -0,0 +1,52 @@
+# Repository Guidelines
+
+Before touching a subsystem, read the relevant notes in `contributing/`: `ARCHITECTURE.md`,
+`PIPELINES.md`, `LOCKING.md`, `MIGRATIONS.md`, `RUNS-AND-JOBS.md`, `AUTOSCALING.md`,
+`BACKENDS.md`, `GPUHUNT.md`, `PROXY.md`, `RUNNER-AND-SHIM.md`, `FRONTEND.md`, `DOCS.md`,
+`DEVELOPMENT.md`, `RELEASE.md`.
+
+## Project Structure & Module Organization
+- Core Python package lives in `src/dstack`; internal modules (including server) sit under `_internal`, API surfaces under `api`, and plugin integrations under `plugins`.
+- Tests reside in `src/tests` and mirror package paths; add new suites alongside the code they cover.
+- Frontend lives in `frontend` (React/webpack) and is built into `src/dstack/_internal/server/statics`.
+- Docs sources are in `mkdocs/docs/` with extra contributor notes in `contributing/*.md`.
+
+## Build, Test, and Development Commands
+- Install deps (editable package with extras): `uv sync --all-extras` (uses `.venv` in repo).
+- Run CLI/server from source: `uv run dstack ...` (e.g., `uv run dstack server --port 8000`).
+- Lint/format: `uv run ruff check .` and `uv run ruff format .`.
+- Type check: `uv run pyright -p .`.
+- Test suite: `uv run pytest`.
+- Frontend: from `frontend/` run `npm install`, `npm run build`, then copy `frontend/build` into `src/dstack/_internal/server/statics/`; for dev, `npm run start` with API on port 8000.
+
+## Coding Style & Naming Conventions
+- Python targets 3.10+ with 4-space indentation and max line length of 99 (see `pyproject.toml`; `E501` is ignored but keep lines readable).
+- Imports are sorted via Ruff’s isort settings (`dstack` treated as first-party).
+- Keep primary/public functions before local helper functions in a module section.
+- Roughly keep function definitions in the order they are referenced within a file so call flow stays easy to follow.
+- Prefer early returns over nested `if`/`else` blocks when they make the control flow simpler.
+- Keep private classes, exceptions, and similar implementation-specific types close to the private functions that use them unless they are shared more broadly in the module.
+- Prefer pydantic-style models in `core/models`.
+- Document attributes when the note adds behavior, compatibility, or semantic context that is not obvious from the name and type. Use attribute docstrings without leading newline.
+- Tests use `test_*.py` modules and `test_*` functions; fixtures live near usage.
+- Never make network calls inside a DB session or transaction. Fetch what you need before opening the session, or commit and close it before the call.
+- Don't use function-level (inner) imports to break circular imports. Inject the dependency or move the shared code to a lower-level module instead.
+- Never edit a migration that has already been applied or released; add a new migration instead.
+- Derive paths under `SERVER_DIR_PATH` on access (a `get_*` function), not as module-level constants, so that patching `settings.SERVER_DIR_PATH` redirects all of them. Tests rely on this to keep server state out of the real `~/.dstack`.
+
+## Testing Guidelines
+- Default to `uv run pytest`. Use markers from `src/tests/conftest.py` like `--runpostgres` if need to include specific tests.
+- Scope the run to the change: for trivial or localized edits, run only the affected test modules, `Test*` classes, or `-k` selection instead of the whole suite. Reserve the full suite for broad or cross-cutting changes.
+- Speed up large runs with `-n auto` (pytest-xdist), e.g. `uv run pytest -n auto`.
+- Group tests for the same unit (function/class) using `Test*` classes that mirror unit's name.
+- Keep tests hermetic (network disabled except localhost per `[tool.pytest.ini_options]` in `pyproject.toml`); stub cloud calls with mocks.
+- Keep the suite fast. Never let a test wait on real time.
+- Machinery that costs hundreds of milliseconds per test (spawning a subprocess, starting a container, generating a key, real HTTP) has to earn its place by covering something cheaper tests cannot. Say so in the test when it does. On the other hand, losing black-box coverage or making the test hard to follow is worse than the milliseconds it costs.
+
+## Commit & Pull Request Guidelines
+- Name branches `issue_{issue_num}_{title}` when the work tracks an issue (e.g. `issue_3959_replicated_alb_gateways`), and `pr_{title}` otherwise.
+- Never create git tags. Tags are reserved for releases and are created only by the release process described in `contributing/RELEASE.md`. To mark or share a commit, push an appropriately named branch instead.
+- Commit messages follow the existing style: short, imperative summaries (e.g., “Fix exclude_not_available ignored”); include rationale in the body if needed.
+- For PRs, describe behavior changes and link related issues.
+- Include screenshots or terminal output when touching UX/CLI messages or frontend flows.
+- Always disclose AI Assistance in PRs.

dstack-0.21.2/PKG-INFO

@@ -0,0 +1,575 @@
+Metadata-Version: 2.5
+Name: dstack
+Version: 0.21.2
+Summary: dstack is an open-source orchestration engine for running AI workloads on any cloud or on-premises.
+Project-URL: Homepage, https://dstack.ai
+Project-URL: Source, https://github.com/dstackai/dstack
+Project-URL: Documentation, https://dstack.ai/docs
+Project-URL: Issues, https://github.com/dstackai/dstack/issues
+Project-URL: Changelog, https://github.com/dstackai/dstack/releases
+Project-URL: Discord, https://discord.gg/u8SmfwPpMd
+Author-email: Andrey Cheptsov <andrey@dstack.ai>
+License-File: LICENSE.md
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: apscheduler<4
+Requires-Dist: argcomplete>=3.5.0
+Requires-Dist: cachetools
+Requires-Dist: cryptography
+Requires-Dist: cursor
+Requires-Dist: filelock
+Requires-Dist: gitpython
+Requires-Dist: gpuhunt==0.1.30
+Requires-Dist: ignore-python>=0.2.0
+Requires-Dist: jsonschema
+Requires-Dist: packaging
+Requires-Dist: paramiko>=3.2.0
+Requires-Dist: psutil
+Requires-Dist: pydantic>=2.12
+Requires-Dist: python-dateutil
+Requires-Dist: python-multipart>=0.0.16
+Requires-Dist: pyyaml
+Requires-Dist: questionary>=2.0.1
+Requires-Dist: requests
+Requires-Dist: requests-unixsocket>=0.4.1
+Requires-Dist: rich
+Requires-Dist: rich-argparse
+Requires-Dist: tqdm
+Requires-Dist: typing-extensions>=4.0.0
+Requires-Dist: websocket-client
+Provides-Extra: all
+Requires-Dist: aiocache; extra == 'all'
+Requires-Dist: aiorwlock; extra == 'all'
+Requires-Dist: aiosqlite; extra == 'all'
+Requires-Dist: alembic-postgresql-enum; extra == 'all'
+Requires-Dist: alembic>=1.16.0; extra == 'all'
+Requires-Dist: asyncpg; extra == 'all'
+Requires-Dist: azure-identity>=1.12.0; extra == 'all'
+Requires-Dist: azure-mgmt-authorization>=3.0.0; extra == 'all'
+Requires-Dist: azure-mgmt-compute>=29.1.0; extra == 'all'
+Requires-Dist: azure-mgmt-msi>=7.0.0; extra == 'all'
+Requires-Dist: azure-mgmt-network<28.0.0,>=23.0.0; extra == 'all'
+Requires-Dist: azure-mgmt-resource>=22.0.0; extra == 'all'
+Requires-Dist: azure-mgmt-subscription>=3.1.1; extra == 'all'
+Requires-Dist: boto3>=1.38.13; extra == 'all'
+Requires-Dist: botocore; extra == 'all'
+Requires-Dist: cryptography>=44.0.3; extra == 'all'
+Requires-Dist: docker>=6.0.0; extra == 'all'
+Requires-Dist: elasticsearch>=8.0.0; extra == 'all'
+Requires-Dist: fastapi; extra == 'all'
+Requires-Dist: fluent-logger>=0.10.0; extra == 'all'
+Requires-Dist: google-api-python-client>=2.80.0; extra == 'all'
+Requires-Dist: google-auth>=2.3.0; extra == 'all'
+Requires-Dist: google-cloud-billing>=1.11.0; extra == 'all'
+Requires-Dist: google-cloud-compute>=1.5.0; extra == 'all'
+Requires-Dist: google-cloud-logging>=2.0.0; extra == 'all'
+Requires-Dist: google-cloud-storage>=2.0.0; extra == 'all'
+Requires-Dist: google-cloud-tpu>=1.18.3; extra == 'all'
+Requires-Dist: grpcio>=1.81.0; extra == 'all'
+Requires-Dist: httpx>=0.28.0; extra == 'all'
+Requires-Dist: jinja2; extra == 'all'
+Requires-Dist: kubernetes; extra == 'all'
+Requires-Dist: nebius<0.4,>=0.3.4; extra == 'all'
+Requires-Dist: oci>=2.150.0; extra == 'all'
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.30.0; extra == 'all'
+Requires-Dist: opentelemetry-exporter-prometheus>=0.51b0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-fastapi>=0.51b0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-httpx>=0.51b0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-logging>=0.61b0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-requests>=0.51b0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-sqlalchemy>=0.51b0; extra == 'all'
+Requires-Dist: opentelemetry-instrumentation-system-metrics>=0.51b0; extra == 'all'
+Requires-Dist: opentelemetry-sdk>=1.30.0; extra == 'all'
+Requires-Dist: prometheus-client; extra == 'all'
+Requires-Dist: protobuf>=6.33.5; extra == 'all'
+Requires-Dist: pyopenssl>=23.2.0; extra == 'all'
+Requires-Dist: python-dxf>=12.1.1; extra == 'all'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'all'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'all'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'all'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'all'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'all'
+Requires-Dist: starlette>=0.26.0; extra == 'all'
+Requires-Dist: uvicorn; extra == 'all'
+Requires-Dist: uvicorn[standard]; extra == 'all'
+Requires-Dist: verda>=1.23.0; extra == 'all'
+Requires-Dist: watchfiles; extra == 'all'
+Provides-Extra: aws
+Requires-Dist: aiocache; extra == 'aws'
+Requires-Dist: aiorwlock; extra == 'aws'
+Requires-Dist: aiosqlite; extra == 'aws'
+Requires-Dist: alembic-postgresql-enum; extra == 'aws'
+Requires-Dist: alembic>=1.16.0; extra == 'aws'
+Requires-Dist: asyncpg; extra == 'aws'
+Requires-Dist: boto3>=1.38.13; extra == 'aws'
+Requires-Dist: botocore; extra == 'aws'
+Requires-Dist: docker>=6.0.0; extra == 'aws'
+Requires-Dist: fastapi; extra == 'aws'
+Requires-Dist: grpcio>=1.81.0; extra == 'aws'
+Requires-Dist: httpx>=0.28.0; extra == 'aws'
+Requires-Dist: jinja2; extra == 'aws'
+Requires-Dist: prometheus-client; extra == 'aws'
+Requires-Dist: protobuf>=6.33.5; extra == 'aws'
+Requires-Dist: python-dxf>=12.1.1; extra == 'aws'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'aws'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'aws'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'aws'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'aws'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'aws'
+Requires-Dist: starlette>=0.26.0; extra == 'aws'
+Requires-Dist: uvicorn[standard]; extra == 'aws'
+Requires-Dist: watchfiles; extra == 'aws'
+Provides-Extra: azure
+Requires-Dist: aiocache; extra == 'azure'
+Requires-Dist: aiorwlock; extra == 'azure'
+Requires-Dist: aiosqlite; extra == 'azure'
+Requires-Dist: alembic-postgresql-enum; extra == 'azure'
+Requires-Dist: alembic>=1.16.0; extra == 'azure'
+Requires-Dist: asyncpg; extra == 'azure'
+Requires-Dist: azure-identity>=1.12.0; extra == 'azure'
+Requires-Dist: azure-mgmt-authorization>=3.0.0; extra == 'azure'
+Requires-Dist: azure-mgmt-compute>=29.1.0; extra == 'azure'
+Requires-Dist: azure-mgmt-msi>=7.0.0; extra == 'azure'
+Requires-Dist: azure-mgmt-network<28.0.0,>=23.0.0; extra == 'azure'
+Requires-Dist: azure-mgmt-resource>=22.0.0; extra == 'azure'
+Requires-Dist: azure-mgmt-subscription>=3.1.1; extra == 'azure'
+Requires-Dist: docker>=6.0.0; extra == 'azure'
+Requires-Dist: fastapi; extra == 'azure'
+Requires-Dist: grpcio>=1.81.0; extra == 'azure'
+Requires-Dist: httpx>=0.28.0; extra == 'azure'
+Requires-Dist: jinja2; extra == 'azure'
+Requires-Dist: prometheus-client; extra == 'azure'
+Requires-Dist: protobuf>=6.33.5; extra == 'azure'
+Requires-Dist: python-dxf>=12.1.1; extra == 'azure'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'azure'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'azure'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'azure'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'azure'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'azure'
+Requires-Dist: starlette>=0.26.0; extra == 'azure'
+Requires-Dist: uvicorn[standard]; extra == 'azure'
+Requires-Dist: watchfiles; extra == 'azure'
+Provides-Extra: crusoe
+Requires-Dist: aiocache; extra == 'crusoe'
+Requires-Dist: aiorwlock; extra == 'crusoe'
+Requires-Dist: aiosqlite; extra == 'crusoe'
+Requires-Dist: alembic-postgresql-enum; extra == 'crusoe'
+Requires-Dist: alembic>=1.16.0; extra == 'crusoe'
+Requires-Dist: asyncpg; extra == 'crusoe'
+Requires-Dist: docker>=6.0.0; extra == 'crusoe'
+Requires-Dist: fastapi; extra == 'crusoe'
+Requires-Dist: grpcio>=1.81.0; extra == 'crusoe'
+Requires-Dist: httpx>=0.28.0; extra == 'crusoe'
+Requires-Dist: jinja2; extra == 'crusoe'
+Requires-Dist: prometheus-client; extra == 'crusoe'
+Requires-Dist: protobuf>=6.33.5; extra == 'crusoe'
+Requires-Dist: python-dxf>=12.1.1; extra == 'crusoe'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'crusoe'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'crusoe'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'crusoe'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'crusoe'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'crusoe'
+Requires-Dist: starlette>=0.26.0; extra == 'crusoe'
+Requires-Dist: uvicorn[standard]; extra == 'crusoe'
+Requires-Dist: watchfiles; extra == 'crusoe'
+Provides-Extra: datacrunch
+Requires-Dist: aiocache; extra == 'datacrunch'
+Requires-Dist: aiorwlock; extra == 'datacrunch'
+Requires-Dist: aiosqlite; extra == 'datacrunch'
+Requires-Dist: alembic-postgresql-enum; extra == 'datacrunch'
+Requires-Dist: alembic>=1.16.0; extra == 'datacrunch'
+Requires-Dist: asyncpg; extra == 'datacrunch'
+Requires-Dist: docker>=6.0.0; extra == 'datacrunch'
+Requires-Dist: fastapi; extra == 'datacrunch'
+Requires-Dist: grpcio>=1.81.0; extra == 'datacrunch'
+Requires-Dist: httpx>=0.28.0; extra == 'datacrunch'
+Requires-Dist: jinja2; extra == 'datacrunch'
+Requires-Dist: prometheus-client; extra == 'datacrunch'
+Requires-Dist: protobuf>=6.33.5; extra == 'datacrunch'
+Requires-Dist: python-dxf>=12.1.1; extra == 'datacrunch'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'datacrunch'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'datacrunch'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'datacrunch'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'datacrunch'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'datacrunch'
+Requires-Dist: starlette>=0.26.0; extra == 'datacrunch'
+Requires-Dist: uvicorn[standard]; extra == 'datacrunch'
+Requires-Dist: verda>=1.23.0; extra == 'datacrunch'
+Requires-Dist: watchfiles; extra == 'datacrunch'
+Provides-Extra: fluentbit
+Requires-Dist: aiocache; extra == 'fluentbit'
+Requires-Dist: aiorwlock; extra == 'fluentbit'
+Requires-Dist: aiosqlite; extra == 'fluentbit'
+Requires-Dist: alembic-postgresql-enum; extra == 'fluentbit'
+Requires-Dist: alembic>=1.16.0; extra == 'fluentbit'
+Requires-Dist: asyncpg; extra == 'fluentbit'
+Requires-Dist: docker>=6.0.0; extra == 'fluentbit'
+Requires-Dist: elasticsearch>=8.0.0; extra == 'fluentbit'
+Requires-Dist: fastapi; extra == 'fluentbit'
+Requires-Dist: fluent-logger>=0.10.0; extra == 'fluentbit'
+Requires-Dist: grpcio>=1.81.0; extra == 'fluentbit'
+Requires-Dist: httpx>=0.28.0; extra == 'fluentbit'
+Requires-Dist: jinja2; extra == 'fluentbit'
+Requires-Dist: prometheus-client; extra == 'fluentbit'
+Requires-Dist: protobuf>=6.33.5; extra == 'fluentbit'
+Requires-Dist: python-dxf>=12.1.1; extra == 'fluentbit'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'fluentbit'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'fluentbit'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'fluentbit'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'fluentbit'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'fluentbit'
+Requires-Dist: starlette>=0.26.0; extra == 'fluentbit'
+Requires-Dist: uvicorn[standard]; extra == 'fluentbit'
+Requires-Dist: watchfiles; extra == 'fluentbit'
+Provides-Extra: gateway
+Requires-Dist: aiocache; extra == 'gateway'
+Requires-Dist: aiorwlock; extra == 'gateway'
+Requires-Dist: fastapi; extra == 'gateway'
+Requires-Dist: httpx>=0.28.0; extra == 'gateway'
+Requires-Dist: jinja2; extra == 'gateway'
+Requires-Dist: starlette>=0.26.0; extra == 'gateway'
+Requires-Dist: uvicorn; extra == 'gateway'
+Provides-Extra: gcp
+Requires-Dist: aiocache; extra == 'gcp'
+Requires-Dist: aiorwlock; extra == 'gcp'
+Requires-Dist: aiosqlite; extra == 'gcp'
+Requires-Dist: alembic-postgresql-enum; extra == 'gcp'
+Requires-Dist: alembic>=1.16.0; extra == 'gcp'
+Requires-Dist: asyncpg; extra == 'gcp'
+Requires-Dist: docker>=6.0.0; extra == 'gcp'
+Requires-Dist: fastapi; extra == 'gcp'
+Requires-Dist: google-api-python-client>=2.80.0; extra == 'gcp'
+Requires-Dist: google-auth>=2.3.0; extra == 'gcp'
+Requires-Dist: google-cloud-billing>=1.11.0; extra == 'gcp'
+Requires-Dist: google-cloud-compute>=1.5.0; extra == 'gcp'
+Requires-Dist: google-cloud-logging>=2.0.0; extra == 'gcp'
+Requires-Dist: google-cloud-storage>=2.0.0; extra == 'gcp'
+Requires-Dist: google-cloud-tpu>=1.18.3; extra == 'gcp'
+Requires-Dist: grpcio>=1.81.0; extra == 'gcp'
+Requires-Dist: httpx>=0.28.0; extra == 'gcp'
+Requires-Dist: jinja2; extra == 'gcp'
+Requires-Dist: prometheus-client; extra == 'gcp'
+Requires-Dist: protobuf>=6.33.5; extra == 'gcp'
+Requires-Dist: python-dxf>=12.1.1; extra == 'gcp'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'gcp'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'gcp'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'gcp'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'gcp'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'gcp'
+Requires-Dist: starlette>=0.26.0; extra == 'gcp'
+Requires-Dist: uvicorn[standard]; extra == 'gcp'
+Requires-Dist: watchfiles; extra == 'gcp'
+Provides-Extra: kubernetes
+Requires-Dist: aiocache; extra == 'kubernetes'
+Requires-Dist: aiorwlock; extra == 'kubernetes'
+Requires-Dist: aiosqlite; extra == 'kubernetes'
+Requires-Dist: alembic-postgresql-enum; extra == 'kubernetes'
+Requires-Dist: alembic>=1.16.0; extra == 'kubernetes'
+Requires-Dist: asyncpg; extra == 'kubernetes'
+Requires-Dist: docker>=6.0.0; extra == 'kubernetes'
+Requires-Dist: fastapi; extra == 'kubernetes'
+Requires-Dist: grpcio>=1.81.0; extra == 'kubernetes'
+Requires-Dist: httpx>=0.28.0; extra == 'kubernetes'
+Requires-Dist: jinja2; extra == 'kubernetes'
+Requires-Dist: kubernetes; extra == 'kubernetes'
+Requires-Dist: prometheus-client; extra == 'kubernetes'
+Requires-Dist: protobuf>=6.33.5; extra == 'kubernetes'
+Requires-Dist: python-dxf>=12.1.1; extra == 'kubernetes'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'kubernetes'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'kubernetes'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'kubernetes'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'kubernetes'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'kubernetes'
+Requires-Dist: starlette>=0.26.0; extra == 'kubernetes'
+Requires-Dist: uvicorn[standard]; extra == 'kubernetes'
+Requires-Dist: watchfiles; extra == 'kubernetes'
+Provides-Extra: lambda
+Requires-Dist: aiocache; extra == 'lambda'
+Requires-Dist: aiorwlock; extra == 'lambda'
+Requires-Dist: aiosqlite; extra == 'lambda'
+Requires-Dist: alembic-postgresql-enum; extra == 'lambda'
+Requires-Dist: alembic>=1.16.0; extra == 'lambda'
+Requires-Dist: asyncpg; extra == 'lambda'
+Requires-Dist: boto3>=1.38.13; extra == 'lambda'
+Requires-Dist: botocore; extra == 'lambda'
+Requires-Dist: docker>=6.0.0; extra == 'lambda'
+Requires-Dist: fastapi; extra == 'lambda'
+Requires-Dist: grpcio>=1.81.0; extra == 'lambda'
+Requires-Dist: httpx>=0.28.0; extra == 'lambda'
+Requires-Dist: jinja2; extra == 'lambda'
+Requires-Dist: prometheus-client; extra == 'lambda'
+Requires-Dist: protobuf>=6.33.5; extra == 'lambda'
+Requires-Dist: python-dxf>=12.1.1; extra == 'lambda'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'lambda'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'lambda'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'lambda'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'lambda'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'lambda'
+Requires-Dist: starlette>=0.26.0; extra == 'lambda'
+Requires-Dist: uvicorn[standard]; extra == 'lambda'
+Requires-Dist: watchfiles; extra == 'lambda'
+Provides-Extra: nebius
+Requires-Dist: aiocache; extra == 'nebius'
+Requires-Dist: aiorwlock; extra == 'nebius'
+Requires-Dist: aiosqlite; extra == 'nebius'
+Requires-Dist: alembic-postgresql-enum; extra == 'nebius'
+Requires-Dist: alembic>=1.16.0; extra == 'nebius'
+Requires-Dist: asyncpg; extra == 'nebius'
+Requires-Dist: docker>=6.0.0; extra == 'nebius'
+Requires-Dist: fastapi; extra == 'nebius'
+Requires-Dist: grpcio>=1.81.0; extra == 'nebius'
+Requires-Dist: httpx>=0.28.0; extra == 'nebius'
+Requires-Dist: jinja2; extra == 'nebius'
+Requires-Dist: nebius<0.4,>=0.3.4; extra == 'nebius'
+Requires-Dist: prometheus-client; extra == 'nebius'
+Requires-Dist: protobuf>=6.33.5; extra == 'nebius'
+Requires-Dist: python-dxf>=12.1.1; extra == 'nebius'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'nebius'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'nebius'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'nebius'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'nebius'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'nebius'
+Requires-Dist: starlette>=0.26.0; extra == 'nebius'
+Requires-Dist: uvicorn[standard]; extra == 'nebius'
+Requires-Dist: watchfiles; extra == 'nebius'
+Provides-Extra: oci
+Requires-Dist: aiocache; extra == 'oci'
+Requires-Dist: aiorwlock; extra == 'oci'
+Requires-Dist: aiosqlite; extra == 'oci'
+Requires-Dist: alembic-postgresql-enum; extra == 'oci'
+Requires-Dist: alembic>=1.16.0; extra == 'oci'
+Requires-Dist: asyncpg; extra == 'oci'
+Requires-Dist: cryptography>=44.0.3; extra == 'oci'
+Requires-Dist: docker>=6.0.0; extra == 'oci'
+Requires-Dist: fastapi; extra == 'oci'
+Requires-Dist: grpcio>=1.81.0; extra == 'oci'
+Requires-Dist: httpx>=0.28.0; extra == 'oci'
+Requires-Dist: jinja2; extra == 'oci'
+Requires-Dist: oci>=2.150.0; extra == 'oci'
+Requires-Dist: prometheus-client; extra == 'oci'
+Requires-Dist: protobuf>=6.33.5; extra == 'oci'
+Requires-Dist: pyopenssl>=23.2.0; extra == 'oci'
+Requires-Dist: python-dxf>=12.1.1; extra == 'oci'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'oci'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'oci'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'oci'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'oci'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'oci'
+Requires-Dist: starlette>=0.26.0; extra == 'oci'
+Requires-Dist: uvicorn[standard]; extra == 'oci'
+Requires-Dist: watchfiles; extra == 'oci'
+Provides-Extra: otel
+Requires-Dist: aiocache; extra == 'otel'
+Requires-Dist: aiorwlock; extra == 'otel'
+Requires-Dist: aiosqlite; extra == 'otel'
+Requires-Dist: alembic-postgresql-enum; extra == 'otel'
+Requires-Dist: alembic>=1.16.0; extra == 'otel'
+Requires-Dist: asyncpg; extra == 'otel'
+Requires-Dist: docker>=6.0.0; extra == 'otel'
+Requires-Dist: fastapi; extra == 'otel'
+Requires-Dist: grpcio>=1.81.0; extra == 'otel'
+Requires-Dist: httpx>=0.28.0; extra == 'otel'
+Requires-Dist: jinja2; extra == 'otel'
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.30.0; extra == 'otel'
+Requires-Dist: opentelemetry-exporter-prometheus>=0.51b0; extra == 'otel'
+Requires-Dist: opentelemetry-instrumentation-fastapi>=0.51b0; extra == 'otel'
+Requires-Dist: opentelemetry-instrumentation-httpx>=0.51b0; extra == 'otel'
+Requires-Dist: opentelemetry-instrumentation-logging>=0.61b0; extra == 'otel'
+Requires-Dist: opentelemetry-instrumentation-requests>=0.51b0; extra == 'otel'
+Requires-Dist: opentelemetry-instrumentation-sqlalchemy>=0.51b0; extra == 'otel'
+Requires-Dist: opentelemetry-instrumentation-system-metrics>=0.51b0; extra == 'otel'
+Requires-Dist: opentelemetry-sdk>=1.30.0; extra == 'otel'
+Requires-Dist: prometheus-client; extra == 'otel'
+Requires-Dist: protobuf>=6.33.5; extra == 'otel'
+Requires-Dist: python-dxf>=12.1.1; extra == 'otel'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'otel'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'otel'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'otel'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'otel'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'otel'
+Requires-Dist: starlette>=0.26.0; extra == 'otel'
+Requires-Dist: uvicorn[standard]; extra == 'otel'
+Requires-Dist: watchfiles; extra == 'otel'
+Provides-Extra: server
+Requires-Dist: aiocache; extra == 'server'
+Requires-Dist: aiorwlock; extra == 'server'
+Requires-Dist: aiosqlite; extra == 'server'
+Requires-Dist: alembic-postgresql-enum; extra == 'server'
+Requires-Dist: alembic>=1.16.0; extra == 'server'
+Requires-Dist: asyncpg; extra == 'server'
+Requires-Dist: docker>=6.0.0; extra == 'server'
+Requires-Dist: fastapi; extra == 'server'
+Requires-Dist: grpcio>=1.81.0; extra == 'server'
+Requires-Dist: httpx>=0.28.0; extra == 'server'
+Requires-Dist: jinja2; extra == 'server'
+Requires-Dist: prometheus-client; extra == 'server'
+Requires-Dist: protobuf>=6.33.5; extra == 'server'
+Requires-Dist: python-dxf>=12.1.1; extra == 'server'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'server'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'server'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'server'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'server'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'server'
+Requires-Dist: starlette>=0.26.0; extra == 'server'
+Requires-Dist: uvicorn[standard]; extra == 'server'
+Requires-Dist: watchfiles; extra == 'server'
+Provides-Extra: verda
+Requires-Dist: aiocache; extra == 'verda'
+Requires-Dist: aiorwlock; extra == 'verda'
+Requires-Dist: aiosqlite; extra == 'verda'
+Requires-Dist: alembic-postgresql-enum; extra == 'verda'
+Requires-Dist: alembic>=1.16.0; extra == 'verda'
+Requires-Dist: asyncpg; extra == 'verda'
+Requires-Dist: docker>=6.0.0; extra == 'verda'
+Requires-Dist: fastapi; extra == 'verda'
+Requires-Dist: grpcio>=1.81.0; extra == 'verda'
+Requires-Dist: httpx>=0.28.0; extra == 'verda'
+Requires-Dist: jinja2; extra == 'verda'
+Requires-Dist: prometheus-client; extra == 'verda'
+Requires-Dist: protobuf>=6.33.5; extra == 'verda'
+Requires-Dist: python-dxf>=12.1.1; extra == 'verda'
+Requires-Dist: python-json-logger>=3.1.0; extra == 'verda'
+Requires-Dist: sentry-sdk[fastapi]>=2.27.0; extra == 'verda'
+Requires-Dist: smg-grpc-proto==0.4.9; extra == 'verda'
+Requires-Dist: sqlalchemy-utils>=0.40.0; extra == 'verda'
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0; extra == 'verda'
+Requires-Dist: starlette>=0.26.0; extra == 'verda'
+Requires-Dist: uvicorn[standard]; extra == 'verda'
+Requires-Dist: verda>=1.23.0; extra == 'verda'
+Requires-Dist: watchfiles; extra == 'verda'
+Description-Content-Type: text/markdown
+
+<div style="text-align: center;">
+<h2>
+  <a target="_blank" href="https://dstack.ai">
+    <img alt="dstack" src="https://raw.githubusercontent.com/dstackai/dstack/master/mkdocs/assets/images/dstack-logo.svg" width="350px"/>
+  </a>
+</h2>
+
+[![Last commit](https://img.shields.io/github/last-commit/dstackai/dstack?style=flat-square)](https://github.com/dstackai/dstack/commits/)
+[![PyPI - License](https://img.shields.io/pypi/l/dstack?style=flat-square&color=blue)](https://github.com/dstackai/dstack/blob/master/LICENSE.md)
+[![Discord](https://img.shields.io/discord/1106906313969123368?style=flat-square)](https://discord.gg/u8SmfwPpMd)
+
+</div>
+
+`dstack` is a unified control plane for GPU provisioning and orchestration that works with any GPU cloud, Kubernetes, or on-prem clusters. 
+
+It streamlines development, training, and inference, and is compatible with any hardware, open-source tools, and frameworks.
+
+#### Accelerators
+
+`dstack` supports `NVIDIA`, `AMD`, `Google TPU`, and `Tenstorrent` accelerators out of the box.
+
+## Latest news ✨
+- [2026/08] [dstack 0.21.0: Pydantic v2, Gateway replicas](https://github.com/dstackai/dstack/releases/tag/0.21.0)
+- [2026/07] [dstack 0.20.29: Presets — agent-driven inference optimization (experimental)](https://dstack.ai/docs/concepts/presets/)
+- [2026/07] [dstack 0.20.27: Slurm backend](https://github.com/dstackai/dstack/releases/tag/0.20.27)
+- [2026/05] [dstack 0.20.21: Kubernetes multiple clusters](https://github.com/dstackai/dstack/releases/tag/0.20.21)
+- [2026/05] [dstack 0.20.20: NVIDIA Dynamo integration](https://github.com/dstackai/dstack/releases/tag/0.20.20)
+- [2026/04] [dstack 0.20.17: Kubernetes volumes](https://github.com/dstackai/dstack/releases/tag/0.20.17)
+- [2026/02] [dstack 0.20.10: PD disaggregation support](https://github.com/dstackai/dstack/releases/tag/0.20.10)
+- [2026/01] [dstack 0.20.7: Replica groups](https://github.com/dstackai/dstack/releases/tag/0.20.7)
+
+## How does it work?
+
+<img src="https://dstack.ai/static-assets/static-assets/images/dstack-architecture-diagram.svg" width="750" />
+
+### Launch the server
+
+> Before using `dstack` through CLI or API, set up a `dstack` server. If you already have a running `dstack` server, you only need to [install the CLI](#install-the-cli).
+
+To orchestrate compute across GPU clouds or Kubernetes clusters, you need to [configure backends](https://dstack.ai/docs/concepts/backends).
+
+> When using `dstack` with on-prem servers, backend configuration isn’t required. Simply create [SSH fleets](https://dstack.ai/docs/concepts/fleets#ssh-fleets) once the server is up.
+
+The server can be installed on Linux, macOS, and Windows (via WSL 2). It requires Git and
+OpenSSH.
+
+```shell
+$ uv tool install "dstack[all]" -U
+$ dstack server
+
+Applying ~/.dstack/server/config.yml...
+
+The admin token is "bbae0f28-d3dd-4820-bf61-8f4bb40815da"
+The server is running at http://127.0.0.1:3000/
+```
+
+> For more details on server configuration options, see the
+[Server deployment](https://dstack.ai/docs/guides/server-deployment) guide.
+
+### Install the CLI
+
+<details><summary>If the CLI is not installed with the server</summary>
+
+Once the server is up, you can access it via the `dstack` CLI.
+
+The CLI can be installed on Linux, macOS, and Windows. It requires Git and OpenSSH.
+
+```shell
+$ uv tool install dstack -U
+```
+
+To point the CLI to the `dstack` server, configure it
+with the server address, user token, and project name:
+
+```shell
+$ dstack project add \
+    --name main \
+    --url http://127.0.0.1:3000 \
+    --token bbae0f28-d3dd-4820-bf61-8f4bb40815da
+
+Configuration is updated at ~/.dstack/config.yml
+```
+
+</details>
+
+### Install agent skills
+
+Install [`dstack` skills](https://skills.sh/dstackai/dstack/dstack) to help AI agents use the CLI and edit configuration files.
+
+```shell
+$ npx skills add dstackai/dstack
+```
+
+AI agents like Claude, Codex, and Cursor can now create and manage fleets and submit workloads on your behalf.
+
+### Define configurations
+
+`dstack` supports the following configurations:
+   
+* [Fleets](https://dstack.ai/docs/concepts/fleets) &mdash; Provision and manage clusters across clouds, Kubernetes, and on-prem
+* [Dev environments](https://dstack.ai/docs/concepts/dev-environments) &mdash; Launch dev environments to be accessed by agents or from your IDE
+* [Tasks](https://dstack.ai/docs/concepts/tasks) &mdash; Run training, batch or other jobs across a single node or clusters
+* [Services](https://dstack.ai/docs/concepts/services) &mdash; Deploy model inference as secure and scalable endpoints
+* [Presets](https://dstack.ai/docs/concepts/presets) &mdash; Agent-driven inference optimization (experimental)
+* [Volumes](https://dstack.ai/docs/concepts/volumes) &mdash; Managing instance and network volumes for persisting data
+
+Configuration can be defined as YAML files within your repo.
+
+### Apply configurations
+
+Apply the configuration via the `dstack apply` CLI command, a programmatic API, or through [AI agent skills](#install-ai-agent-skills).
+
+`dstack` automatically manages provisioning, job queuing, auto-scaling, networking, volumes, run failures,
+out-of-capacity errors, port-forwarding, and more &mdash; across clouds and on-prem clusters.
+
+## Useful links
+
+For additional information, see the following links:
+
+* [Docs](https://dstack.ai/docs)
+* [Examples](https://dstack.ai/examples)
+* [Discord](https://discord.gg/u8SmfwPpMd)
+
+## Contributing
+
+You're very welcome to contribute to `dstack`. 
+Learn more about how to contribute to the project at [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+[Mozilla Public License 2.0](LICENSE.md)