You can only run locally after having successfully run the azd up
command. If you haven't yet, follow the steps in Azure deployment above.
- Run
azd auth login
- Change dir to
app
- Run
./start.ps1
or./start.sh
or run the "VS Code Task: Start App" to start the project locally.
When you run ./start.ps1
or ./start.sh
, the backend files will be watched and reloaded automatically. However, the frontend files will not be watched and reloaded automatically.
To enable hot reloading of frontend files, open a new terminal and navigate to the frontend directory:
cd app/frontend
Then run:
npm run dev
You should see:
> [email protected] dev
> vite
VITE v4.5.1 ready in 957 ms
➜ Local: http://localhost:5173/
➜ Network: use --host to expose
➜ press h to show help
Navigate to the URL shown in the terminal (in this case, http://localhost:5173/
). This local server will watch and reload frontend files. All backend requests will be routed to the Python server according to vite.config.ts
.
Then, whenever you make changes to frontend files, the changes will be automatically reloaded, without any browser refresh needed.
You may want to save costs by developing against a local LLM server, such as llamafile. Note that a local LLM will generally be slower and not as sophisticated.
Once you've got your local LLM running and serving an OpenAI-compatible endpoint, set these environment variables:
azd env set OPENAI_HOST local
azd env set OPENAI_BASE_URL <your local endpoint>
For example, to point at a local llamafile server running on its default port:
azd env set OPENAI_BASE_URL http://localhost:8080/v1
If you're running inside a dev container, use this local URL instead:
azd env set OPENAI_BASE_URL http://host.docker.internal:8080/v1