Back to Details

quickstart

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Quickstart & Authentication

快速启动与认证

Prerequisites

前提条件

  • uv (Python package manager)
  • nvm with Node 20 (for frontend)
  • Databricks CLI v0.283.0+
Check CLI version:
bash
databricks -v  # Must be v0.283.0 or above
brew upgrade databricks  # If version is too old
  • uv（Python包管理器）
  • nvm 及 Node 20（用于前端）
  • Databricks CLI v0.283.0+
检查CLI版本：
bash
databricks -v  # 必须为v0.283.0或更高版本
brew upgrade databricks  # 如果版本过旧

Run Quickstart

运行快速启动命令

bash
uv run quickstart
Options:
  • --profile NAME
    : Use specified profile (non-interactive)
  • --host URL
    : Workspace URL for initial setup
  • -h, --help
    : Show help
Examples:
bash
undefined
bash
uv run quickstart
选项：
  • --profile NAME
    : 使用指定的配置文件（非交互式）
  • --host URL
    : 用于初始设置的工作区URL
  • -h, --help
    : 显示帮助信息
示例：
bash
undefined

Interactive (prompts for profile selection)

交互式（提示选择配置文件）

uv run quickstart
uv run quickstart

Non-interactive with existing profile

使用现有配置文件的非交互式模式

uv run quickstart --profile DEFAULT
uv run quickstart --profile DEFAULT

New workspace setup

新工作区设置

uv run quickstart --host https://your-workspace.cloud.databricks.com
undefined
uv run quickstart --host https://your-workspace.cloud.databricks.com
undefined

What Quickstart Configures

快速启动命令的配置内容

Creates/updates 
.env
with:
  • DATABRICKS_CONFIG_PROFILE
    - Selected CLI profile
  • MLFLOW_TRACKING_URI
    - Set to 
    databricks://<profile-name>
    for local auth
  • MLFLOW_EXPERIMENT_ID
    - Auto-created experiment ID
创建或更新
.env
文件，包含以下内容：
  • DATABRICKS_CONFIG_PROFILE
    - 选中的CLI配置文件
  • MLFLOW_TRACKING_URI
    - 设置为
    databricks://<profile-name>
    以实现本地认证
  • MLFLOW_EXPERIMENT_ID
    - 自动创建的实验ID

Manual Authentication (Fallback)

手动认证（备选方案）

If quickstart fails:
bash
undefined
如果快速启动命令失败：
bash
undefined

Create new profile

创建新配置文件

databricks auth login --host https://your-workspace.cloud.databricks.com
databricks auth login --host https://your-workspace.cloud.databricks.com

Verify

验证

databricks auth profiles

Then manually create `.env` (copy from `.env.example`):
```bash
databricks auth profiles

然后手动创建`.env`文件（复制`.env.example`内容）：
```bash

Authentication (choose one method)

认证（选择一种方式）

DATABRICKS_CONFIG_PROFILE=DEFAULT
DATABRICKS_CONFIG_PROFILE=DEFAULT

DATABRICKS_HOST=https://<your-workspace-here>.databricks.com

DATABRICKS_HOST=https://<your-workspace-here>.databricks.com

DATABRICKS_TOKEN=dapi....

DATABRICKS_TOKEN=dapi....

MLflow configuration

MLflow配置

MLFLOW_EXPERIMENT_ID=<your-experiment-id> MLFLOW_TRACKING_URI="databricks://DEFAULT" MLFLOW_REGISTRY_URI="databricks-uc"
MLFLOW_EXPERIMENT_ID=<your-experiment-id> MLFLOW_TRACKING_URI="databricks://DEFAULT" MLFLOW_REGISTRY_URI="databricks-uc"

Frontend proxy settings

前端代理设置

CHAT_APP_PORT=3000 CHAT_PROXY_TIMEOUT_SECONDS=300
undefined
CHAT_APP_PORT=3000 CHAT_PROXY_TIMEOUT_SECONDS=300
undefined

Next Steps

后续步骤

After quickstart completes:
  1. Run 
    uv run discover-tools
    to find available workspace resources (see discover-tools skill)
  2. Run 
    uv run start-app
    to test locally (see run-locally skill)
快速启动完成后：
  1. 运行
    uv run discover-tools
    以查找可用的工作区资源（详见discover-tools技能）
  2. 运行
    uv run start-app
    进行本地测试（详见run-locally技能）