Configure dev environment

Python Environment

Create and Activate

python -m venv .venv

WindowsmacOS/Linux

.venv\Scripts\activate

source .venv/bin/activate

Install Dependencies

Fast (Recommended)Standard

pip install uv && uv pip install -r scripts/requirements.txt

pip install -r scripts/requirements.txt

Verify Setup

python -c "import azure.ai.projects; print('Ready')"

Configure Fabric

Using Azure-Only Mode?

If you set AZURE_ENV_ONLY=true before deployment, skip this section and proceed to Update Environment File. Fabric configuration is not required when using Azure SQL.

Get Your Workspace ID

1. Go to Microsoft Fabric
2. Open your workspace
3. Copy the workspace ID from the URL:

https://app.fabric.microsoft.com/groups/{workspace-id}/...

Update Environment File

Copy .env.example to .env and update your Fabric settings:

cp .env.example .env

Edit .env in the project root:

# --- Microsoft Fabric (not required for Azure-only mode) ---
FABRIC_WORKSPACE_ID=your-workspace-id-here

# --- Data Folder (pre-populated with default scenario) ---
DATA_FOLDER=data/default

Checkpoint

Before proceeding:

• azd up completed successfully
• Python environment activated
• Dependencies installed
• Fabric workspace ID configured (skip if using Azure-only mode)

Ready to Run

Continue to the next step to see it in action.

---

← Create Fabric workspace | Build solution →