You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: documents/LocalDevelopmentSetup.md
+49-5Lines changed: 49 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -293,6 +293,46 @@ Create `.vscode/settings.json` and copy the following JSON:
293
293
294
294
---
295
295
296
+
### Running with Automated Script
297
+
298
+
For convenience, you can use the provided startup scripts that handle environment setup and start both backend and frontend services automatically. This is the quickest way to get up and running locally.
299
+
300
+
> **Note**: You must complete **Step 1 (Prerequisites)** and **Step 2 (Development Tools Setup)** before using the automated scripts.
301
+
302
+
#### Windows (Command Prompt or PowerShell):
303
+
304
+
```cmd
305
+
cd src
306
+
.\start.cmd
307
+
```
308
+
309
+
#### macOS/Linux/WSL:
310
+
311
+
```bash
312
+
cd src
313
+
chmod +x start.sh
314
+
./start.sh
315
+
```
316
+
317
+
### What the Scripts Do
318
+
319
+
The startup scripts automatically handle:
320
+
- Environment variable configuration
321
+
- Azure authentication
322
+
- Azure RBAC role assignments (Cosmos DB, SQL Server, AI Foundry, AI Search)
323
+
- Python virtual environment setup
324
+
- Backend dependency installation
325
+
- Frontend dependency installation
326
+
- Starting both backend and frontend servers
327
+
328
+
> **Note**: The script includes a 30-second wait for the backend to initialize before starting the frontend. If you see connection errors initially, wait a moment and reload the page.
329
+
330
+
---
331
+
332
+
## Running Backend and Frontend Manually
333
+
334
+
If you prefer more control over the setup process, follow the steps below to configure and run each service individually.
335
+
296
336
## Step 3: Azure Authentication Setup
297
337
298
338
Before configuring services, authenticate with Azure:
@@ -385,13 +425,17 @@ az role assignment create \
385
425
```
386
426
387
427
#### Cosmos DB Access
388
-
389
428
```bash
429
+
# Get your principal ID
430
+
PRINCIPAL_ID=$(az ad signed-in-user show --query id -o tsv)
0 commit comments