Skip to main content

dstack is an open-source orchestration engine for running AI workloads on any cloud or on-premises.

Project description

dstack is an open-source container orchestration engine designed for running AI workloads across any cloud or data center. It simplifies dev environments, running tasks on clusters, and deployment.

The supported cloud providers include AWS, GCP, Azure, OCI, Lambda, TensorDock, Vast.ai, RunPod, and CUDO. You can also use dstack to run workloads on on-prem clusters.

dstack natively supports NVIDIA GPU, and Google Cloud TPU accelerator chips.

Latest news ✨

Installation

Before using dstack through CLI or API, set up a dstack server.

Install the server

The easiest way to install the server, is via pip:

pip install "dstack[all]" -U

Configure backends

If you have default AWS, GCP, Azure, or OCI credentials on your machine, the dstack server will pick them up automatically.

Otherwise, you need to manually specify the cloud credentials in ~/.dstack/server/config.yml.

See the server/config.yml reference for details on how to configure backends for all supported cloud providers.

Start the server

To start the server, use the dstack server command:

$ 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/

Note It's also possible to run the server via Docker.

CLI & API

Once the server is up, you can use either dstack's CLI or API to run workloads. Below is a live demo of how it works with the CLI.

Dev environments

You specify the required environment and resources, then run it. dstack provisions the dev environment in the cloud and enables access via your desktop IDE.

Tasks

Tasks allow for convenient scheduling of any kind of batch jobs, such as training, fine-tuning, or data processing, as well as running web applications.

Specify the environment and resources, then run it. dstack executes the task in the cloud, enabling port forwarding to your local machine for convenient access.

Services

Services make it very easy to deploy any kind of model or web application as public endpoints.

Use any serving frameworks and specify required resources. dstack deploys it in the configured backend, handles authorization, and provides an OpenAI-compatible interface if needed.

Pools

Pools simplify managing the lifecycle of cloud instances and enable their efficient reuse across runs.

You can have instances provisioned in the cloud automatically, or add them manually, configuring the required resources, idle duration, etc.

Examples

Here are some featured examples:

Browse examples for more examples.

More information

For additional information and examples, see the following links:

Contributing

We welcome contributions to dstack! To learn more about getting involved in the project, please refer to CONTRIBUTING.md.

License

Mozilla Public License 2.0

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dstack-0.18.5rc1.tar.gz (292.6 kB view details)

Uploaded Source

Built Distribution

dstack-0.18.5rc1-py3-none-any.whl (440.8 kB view details)

Uploaded Python 3

File details

Details for the file dstack-0.18.5rc1.tar.gz.

File metadata

  • Download URL: dstack-0.18.5rc1.tar.gz
  • Upload date:
  • Size: 292.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.19

File hashes

Hashes for dstack-0.18.5rc1.tar.gz
Algorithm Hash digest
SHA256 acf96983ffd29a8bc0d3f7585eda1be585a80bdc0f893a67e7fadcc84cec049d
MD5 9ebb44ad047deffd93b179e56d80211c
BLAKE2b-256 d87f16c589192c092b56b2e0fe68266b6f2ad854b58848322536c8ccb9c9baa4

See more details on using hashes here.

File details

Details for the file dstack-0.18.5rc1-py3-none-any.whl.

File metadata

  • Download URL: dstack-0.18.5rc1-py3-none-any.whl
  • Upload date:
  • Size: 440.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.19

File hashes

Hashes for dstack-0.18.5rc1-py3-none-any.whl
Algorithm Hash digest
SHA256 e8b31ea57497d73b865d2bf2e11d79ee627fa5671873bab8314a4ecbad66dc72
MD5 d32e09df571e910d9b219abb5f4f6087
BLAKE2b-256 c864bc878bffd19a2a50c48b3cd1cfeee425e9547bf7e681220e7b488a60bcbd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page