Overhaul demos directory: cleanup, restructure, and standardize configs (#760)

demos/integrations/spotify_bearer_auth/README.md

@@ -0,0 +1,31 @@
+# Use Case Demo: Bearer Authorization with Spotify APIs
+
+In this demo, we show how you can use Plano's bearer authorization capability to connect your agentic apps to third-party APIs.
+More specifically, we demonstrate how you can connect to two Spotify APIs:
+
+- [`/v1/browse/new-releases`](https://developer.spotify.com/documentation/web-api/reference/get-new-releases)
+- [`/v1/artists/{artist_id}/top-tracks`](https://developer.spotify.com/documentation/web-api/reference/get-an-artists-top-tracks)
+
+Where users can engage by asking questions like _"Show me the latest releases in the US"_, followed by queries like _"Show me top tracks from Taylor Swift"_.
+
+![Example of Bearer Authorization with Spotify APIs](spotify_bearer_auth.png)
+
+## Starting the demo
+
+1. Ensure the [prerequisites](https://github.com/katanemo/arch/?tab=readme-ov-file#prerequisites) are installed correctly.
+2. Create an `.env` file with API keys for OpenAI and Spotify.
+   - Sign up for an OpenAI API key at [https://platform.openai.com/signup/](https://platform.openai.com/signup/)
+   - Sign up for a Spotify Client Key/Secret by following instructions at [https://developer.spotify.com/dashboard/](https://developer.spotify.com/dashboard/)
+   - Generate a Spotify token using the [https://accounts.spotify.com/api/token API](https://accounts.spotify.com/api/token), using ```curl``` or similar commands.
+   - Create a .env file with the following keys:
+   ```
+   OPENAI_API_KEY=your_openai_api_key
+   SPOTIFY_CLIENT_KEY=your_spotify_api_token
+   ```
+
+3. Start Plano
+   ```sh
+   sh run_demo.sh
+   ```
+4. Navigate to http://localhost:18080
+5. Ask "show me new album releases in the US"