Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README.md with local run example #1119

Closed
wants to merge 2 commits into from

Conversation

rajbos
Copy link

@rajbos rajbos commented Sep 26, 2024

Motivation and Context

The README does not contain information on testing this app locally (e.g. in a Codespace). Running it takes a lot of trial and error figuring out what to configure. I had to find #649 before I could figure the AUTH_ENABLED setting and from there could debug more.

The lessons learned are in this PR.

Contribution Checklist

  • I have built and tested the code locally and in a deployed app
  • This is a change for all users of this app. No code or asset is specific to my use case or my organization.
  • I didn't break any existing functionality 😄

README.md Outdated
To run the app locally, configure the `.env` file with the correct values, and configure the extra setting `AUTH_ENABLED=false` for testing without the Application Authentication enabled. You can then run from VS Code by using <kbd>F5</kbd>.

If you get an error message: `Unauthorized. Access token is missing, invalid, audience is incorrect`, then run `az login` before running the App. If you still get an error after that, make sure your account has access to the Azure OpenAi instance. You can list the roll assignments and create it through:
`az role assignment create --assignee <your-user-id> --role "Cognitive Services Contributor" --scope /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group>/providers/Microsoft.CognitiveServices/accounts/<your-cognitive-services-account>`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think Cognitive Services OpenAI User would be the recommended data plane role here

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can see that. Updated the branch.

@github-actions github-actions bot added the stale label Nov 27, 2024
@github-actions github-actions bot closed this Dec 11, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants