Skip to main content
Version: devel View Markdown

What is a workspace?

A workspace is a Python project layout that bundles your dlt pipelines, transformations, configuration, and AI toolkit setup into a single deployable unit. The same folder runs on your local machine, in CI, and — when you deploy — on the managed dltHub platform, so what you build locally is what runs in production.

A workspace is where you:

  • Connect a local repo to a remote workspace on dltHub (dlthub workspace connect)
  • Configure destinations, config, and secrets (often via profiles like dev, prod, access)
  • Create and manage pipelines, deployments, jobs/runs, logs, and notebooks
  • Control access via workspace roles (owner, developer, viewer)

When you create an account, dltHub automatically creates a personal Playground workspace so you can try things without any setup.

Every workspace contains:

  • .dlt/.workspace — a marker file that activates the dlthub CLI, profile support, and the managed-platform commands. Without this file you're using plain OSS dlt.
  • .dlt/config.toml and .dlt/secrets.toml — settings and credentials, with optional per-profile overrides (dev, prod, tests, access).
  • pyproject.toml (or requirements.txt) — workspace-level dependencies like dlt[hub], duckdb, marimo.
  • Pipeline files and an optional __deployment__.py manifest — the code you run, and the description of how it's deployed.
  • AI toolkit configuration — skills, rules, and MCP wiring for Claude Code, Cursor, or Codex (added when you opt in during scaffolding).

Creating a workspace​

uv run dlthub login
uv run dlthub workspace connect "<name>" --create

When you deploy, all files from your local project directory are mirrored to the remote workspace on the dltHub platform. To exclude files you don't want deployed (temp directories, data/state directories, local IDE files), list them in .gitignore. Files not excluded can cause deployments to fail with:

Upload failed (HTTP 413): {"status_code":413,"detail":"Request Entity Too Large"}

Next steps​

This demo works on codespaces. Codespaces is a development environment available for free to anyone with a Github account. You'll be asked to fork the demo repository and from there the README guides you with further steps.
The demo uses the Continue VSCode extension.

Off to codespaces!

DHelp

Ask a question

Welcome to "Codex Central", your next-gen help center, driven by OpenAI's GPT-4 model. It's more than just a forum or a FAQ hub – it's a dynamic knowledge base where coders can find AI-assisted solutions to their pressing problems. With GPT-4's powerful comprehension and predictive abilities, Codex Central provides instantaneous issue resolution, insightful debugging, and personalized guidance. Get your code running smoothly with the unparalleled support at Codex Central - coding help reimagined with AI prowess.