NON_DEVCONTAINER_SETUP.md

Back to Chat with your data README

Non-DevContainer Setup

If you are unable to run this accelerator using a DevContainer or in GitHub CodeSpaces, then you will need to install the following prerequisites on your local machine.

• A code editor. We recommend Visual Studio Code, with the following extensions:
  • Azure Functions
  • Azure Tools
  • Bicep
  • Pylance
  • Python
  • Teams Toolkit Optional
• Python 3.11
• Node.js LTS
• Azure Developer CLI (v1.18.0+)
• Azure Functions Core Tools

Setup

1. Review the contents of .devcontainer/setupEnv.sh and then run it:

   .devcontainer/setupEnv.sh

2. Select the Python interpreter in Visual Studio Code:

   • Open the command palette (Ctrl+Shift+P or Cmd+Shift+P).
   • Type Python: Select Interpreter.
   • Select the Python 3.11 environment created by Poetry.

Running the sample using the Azure Developer CLI (azd)

The Azure Developer CLI (azd) is a developer-centric command-line interface (CLI) tool for creating Azure applications.

1. Log in to Azure using azd:

   azd auth login
   

2. Execute the azd init command to initialize the environment and enter the solution accelerator name when prompted:

   azd init -t chat-with-your-data-solution-accelerator
   

3. Run azd up to provision all the resources to Azure and deploy the code to those resources.

   azd up
   

   Note: This solution accelerator requires Azure Developer CLI (azd) version 1.18.0 or higher. Please ensure you have the latest version installed before proceeding with deployment. Download azd here.

   Select your desired subscription and location. Wait a moment for the resource deployment to complete, click the website endpoint and you will see the web app page.

🛠️ Troubleshooting

If you encounter any issues during the deployment process, please refer to the TroubleShootingSteps document for detailed steps and solutions.