jaxl-python 0.0.4__tar.gz → 0.0.6__tar.gz

{jaxl_python-0.0.4 → jaxl_python-0.0.6}/.github/workflows/sdk.yml

@@ -29,7 +29,7 @@ jobs:
           python -m venv .venv
           source .venv/bin/activate
           python -m pip install --upgrade pip
-          pip install -e .[dev,app,grout]
+          pip install -e .[dev,app,grout,silence,transcribe]
       - name: Run mypy
         run: |
           source .venv/bin/activate

{jaxl_python-0.0.4 → jaxl_python-0.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jaxl-python
-Version: 0.0.4
+Version: 0.0.6
 Summary: Jaxl CLI & Jaxl Python API Client.
 Home-page: https://github.com/jaxl-innovations-private-limited/jaxl-python
 Download-URL: https://github.com/jaxl-innovations-private-limited/jaxl-python/archive/main.zip
@@ -42,7 +42,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Typing :: Typed
-Requires-Python: >=3.6
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
 Requires-Dist: httpx<0.24.0,>=0.15.0
@@ -69,6 +69,10 @@ Requires-Dist: uvicorn[standard]==0.35.0; extra == "app"
 Requires-Dist: fastapi==0.116.1; extra == "app"
 Provides-Extra: grout
 Requires-Dist: proxy.py==2.4.10; extra == "grout"
+Provides-Extra: silence
+Requires-Dist: webrtcvad==2.0.10; extra == "silence"
+Provides-Extra: transcribe
+Requires-Dist: openai-whisper==20240930; extra == "transcribe"
 Dynamic: download-url
 Dynamic: license-file
 
@@ -78,7 +82,7 @@ Use Jaxl from Python code or directly via the `jaxl` command-line tool.
 
 1. [Install](#install)
 2. [JAXL CLI](#jaxl-cli)
-   - [CLI Example Usage](#cli-example-usage)
+   - [Setup](#setup)
    - [Verify API Credentials & Auth Token](#verify-api-credentials--auth-token)
    - [Check Account Balance](#check-account-balance)
    - [Create an IVR](#create-an-ivr)
@@ -111,50 +115,56 @@ Use Jaxl from Python code or directly via the `jaxl` command-line tool.
    - [List Consumable Payments](#list-consumable-payments)
 3. [Jaxl Python SDK](#jaxl-python-sdk)
    - [SDK Example Usage](#sdk-example-usage)
-4. [Documentation](#documentation)
-5. [Status](#status)
+4. [JAXL HTTP Webhook Protocol](./SPECIFICATION.md)
+5. [SDK Documentation](#sdk-documentation)
+6. [Status](#status)
 
 ## Install
 
-`pip install jaxl-python`
+`pip install -U jaxl-python`
 
 ## JAXL CLI
 
 ```bash
 jaxl -h
-usage: jaxl [-h] {calls} ...
+usage: jaxl [-h] {accounts,apps,calls,campaigns,devices,ivrs,kycs,members,messages,notifications,payments,phones,teams} ...
 
 Jaxl CLI
 
 positional arguments:
-  {phones,calls,members,teams,ivrs,devices,payments,accounts,kycs,messages,campaigns,notifications}
-    phones              Manage Phones
-    calls               Manage Calls (Domestic & International Cellular, VoIP audio/video)
-    members             Manage Members
-    teams               Manage Teams
-    ivrs                Manage IVRs (Interactive Voice Response)
-    devices             Manage Devices
-    payments            Manage Payments
+  {accounts,apps,calls,campaigns,devices,ivrs,kycs,members,messages,notifications,payments,phones,teams}
     accounts            Manage Accounts
+    apps                Manage Apps for Webhooks and Streaming audio/speech/transcriptions.
+    calls               Manage Calls (Domestic & International Cellular, App-to-App)
+    campaigns           Manage Campaigns
+    devices             Manage Devices
+    ivrs                Manage IVRs (Interactive Voice Response)
     kycs                Manage KYCs
+    members             Manage Members
     messages            Manage Messages (SMS, WA, RCS, Email, App-to-App)
-    campaigns           Manage Campaigns
-    notifications       Manage Notifications (iOS, Android, Web)
+    notifications       Manage Notifications (Android, iOS, Web)
+    payments            Manage Payments
+    phones              Manage Phones (Landline, Mobile, TollFree)
+    teams               Manage Teams (Managers, Phones)
 
 options:
-  -h, --help  show this help message and exit
+  -h, --help            show this help message and exit
 ```
 
-### CLI Example Usage
+### Setup
 
-```bash
-export JAXL_API_CREDENTIALS=/path/to/jaxl-api-credentials.json
+You will require the following to successfully run `jaxl` command line tool:
 
-export JAXL_API_AUTH_TOKEN="....authentication token..."
+- `JAXL_API_CREDENTIALS`: Required to connect with Jaxl API Infrastructure
+- `JAXL_API_AUTH_TOKEN`: Ensure necessary permissions are added to generated auth token.
 
-jaxl accounts me
+Please visit [Jaxl Business Website](https://business.jaxl.com) or download the [Jaxl Business Android](https://play.google.com/store/apps/details?id=com.jaxl.business) or [Jaxl Business iOS](https://apps.apple.com/app/id6451118240) mobile application to access your credentials and auth tokens.
 
-Response(status_code=<HTTPStatus.OK: 200>, content=b'... [redacted] ...')
+Finally, setup following environment variables when trying `jaxl` command line.
+
+```bash
+export JAXL_API_CREDENTIALS=/path/to/jaxl-api-credentials.json
+export JAXL_API_AUTH_TOKEN="....authentication token...."
 ```
 
 ### Verify API Credentials & Auth Token
@@ -240,7 +250,7 @@ jaxl phones ivrs \
 
 Below command will execute the following flow:
 
-- Places a call to <Callee Number>
+- Places a call to &lt;Callee Number&gt;
 - When answered sends them to an existing IVR ID
 - Once IVR finishes, call continues to CTA returned by IVR
 
@@ -434,45 +444,23 @@ webhook before proceeding further.
 
 To control flow of outgoing calls, use webhook IVR ID when placing an outbound call. See [Place Outgoing Cellular Call with Existing IVR](#place-outgoing-cellular-call-with-existing-ivr)
 
-See [examples/app.py](./examples/app.py) for working webhook examples.
+See [examples](https://github.com/jaxl-innovations-private-limited/jaxl-python/tree/main/examples) directory for working webhook examples.
 
 ### Realtime Streaming Audio
 
-Refer to [examples/app.py](./examples/app.py) for working streaming audio examples.
+Refer to [examples](https://github.com/jaxl-innovations-private-limited/jaxl-python/tree/main/examples) directory for working streaming audio examples.
 
 ### Realtime Streaming Speech Segments
 
-Refer to [examples/app.py](./examples/app.py) for working streaming speech segments examples.
+Refer to [examples](https://github.com/jaxl-innovations-private-limited/jaxl-python/tree/main/examples) directory for working streaming speech segments examples.
 
 ### Realtime Streaming Transcriptions per Speech Segment
 
-Refer to [examples/app.py](./examples/app.py) for working streaming transcription per speech segment examples.
+Refer to [examples](https://github.com/jaxl-innovations-private-limited/jaxl-python/tree/main/examples) directory for working streaming transcription per speech segment examples.
 
 ### AI Agent: Realtime Transcriptions STT ➡️ LLM/MCP ➡️ TTS
 
-Refer to [examples/app.py](./examples/app.py) for working AI Agent examples.
-
-```bash
-jaxl calls create \
-  --to "+91<Callee>"
-  --from "+91<Purchased Jaxl Number>" \
-  --transcribe
-```
-
-When `--pipeline` flag is used, Jaxl SDK will:
-
-- Start a local HTTP server for signaling
-- Starts [grout](https://github.com/abhinavsingh/proxy.py?tab=readme-ov-file#grout-ngrok-alternative) so that Jaxl servers can reach our signaling server
-- Pipeline framework will:
-  - Receive raw audio packets from callee and start to perform silence detection
-  - Starts STT conversion for detected speech segments
-  - Use local CPU (or GPUs if available for Silence detection & STT)
-  - Invokes pipeline module's `on_transcription` asynchronously as STT finishes
-
-Within our pipeline module we can then:
-
-- Feed transcription with prior knowledge base to LLM of choice e.g. ChatGPT, Ollama Models etc
-- Send back response from LLM back to the callee
+Refer to [examples](https://github.com/jaxl-innovations-private-limited/jaxl-python/tree/main/examples) directory for working AI Agent examples.
 
 ### List Subscriptions Payments
 
@@ -510,7 +498,7 @@ response = v1_calls_list.sync_detailed(
 )
 ```
 
-## Documentation
+## SDK Documentation
 
 ```
 # Clone this repository

{jaxl_python-0.0.4 → jaxl_python-0.0.6}/README.md

@@ -4,7 +4,7 @@ Use Jaxl from Python code or directly via the `jaxl` command-line tool.
 
 1. [Install](#install)
 2. [JAXL CLI](#jaxl-cli)
-   - [CLI Example Usage](#cli-example-usage)
+   - [Setup](#setup)
    - [Verify API Credentials & Auth Token](#verify-api-credentials--auth-token)
    - [Check Account Balance](#check-account-balance)
    - [Create an IVR](#create-an-ivr)
@@ -37,50 +37,56 @@ Use Jaxl from Python code or directly via the `jaxl` command-line tool.
    - [List Consumable Payments](#list-consumable-payments)
 3. [Jaxl Python SDK](#jaxl-python-sdk)
    - [SDK Example Usage](#sdk-example-usage)
-4. [Documentation](#documentation)
-5. [Status](#status)
+4. [JAXL HTTP Webhook Protocol](./SPECIFICATION.md)
+5. [SDK Documentation](#sdk-documentation)
+6. [Status](#status)
 
 ## Install
 
-`pip install jaxl-python`
+`pip install -U jaxl-python`
 
 ## JAXL CLI
 
 ```bash
 jaxl -h
-usage: jaxl [-h] {calls} ...
+usage: jaxl [-h] {accounts,apps,calls,campaigns,devices,ivrs,kycs,members,messages,notifications,payments,phones,teams} ...
 
 Jaxl CLI
 
 positional arguments:
-  {phones,calls,members,teams,ivrs,devices,payments,accounts,kycs,messages,campaigns,notifications}
-    phones              Manage Phones
-    calls               Manage Calls (Domestic & International Cellular, VoIP audio/video)
-    members             Manage Members
-    teams               Manage Teams
-    ivrs                Manage IVRs (Interactive Voice Response)
-    devices             Manage Devices
-    payments            Manage Payments
+  {accounts,apps,calls,campaigns,devices,ivrs,kycs,members,messages,notifications,payments,phones,teams}
     accounts            Manage Accounts
+    apps                Manage Apps for Webhooks and Streaming audio/speech/transcriptions.
+    calls               Manage Calls (Domestic & International Cellular, App-to-App)
+    campaigns           Manage Campaigns
+    devices             Manage Devices
+    ivrs                Manage IVRs (Interactive Voice Response)
     kycs                Manage KYCs
+    members             Manage Members
     messages            Manage Messages (SMS, WA, RCS, Email, App-to-App)
-    campaigns           Manage Campaigns
-    notifications       Manage Notifications (iOS, Android, Web)
+    notifications       Manage Notifications (Android, iOS, Web)
+    payments            Manage Payments
+    phones              Manage Phones (Landline, Mobile, TollFree)
+    teams               Manage Teams (Managers, Phones)
 
 options:
-  -h, --help  show this help message and exit
+  -h, --help            show this help message and exit
 ```
 
-### CLI Example Usage
+### Setup
 
-```bash
-export JAXL_API_CREDENTIALS=/path/to/jaxl-api-credentials.json
+You will require the following to successfully run `jaxl` command line tool:
 
-export JAXL_API_AUTH_TOKEN="....authentication token..."
+- `JAXL_API_CREDENTIALS`: Required to connect with Jaxl API Infrastructure
+- `JAXL_API_AUTH_TOKEN`: Ensure necessary permissions are added to generated auth token.
 
-jaxl accounts me
+Please visit [Jaxl Business Website](https://business.jaxl.com) or download the [Jaxl Business Android](https://play.google.com/store/apps/details?id=com.jaxl.business) or [Jaxl Business iOS](https://apps.apple.com/app/id6451118240) mobile application to access your credentials and auth tokens.
 
-Response(status_code=<HTTPStatus.OK: 200>, content=b'... [redacted] ...')
+Finally, setup following environment variables when trying `jaxl` command line.
+
+```bash
+export JAXL_API_CREDENTIALS=/path/to/jaxl-api-credentials.json
+export JAXL_API_AUTH_TOKEN="....authentication token...."
 ```
 
 ### Verify API Credentials & Auth Token
@@ -166,7 +172,7 @@ jaxl phones ivrs \
 
 Below command will execute the following flow:
 
-- Places a call to <Callee Number>
+- Places a call to &lt;Callee Number&gt;
 - When answered sends them to an existing IVR ID
 - Once IVR finishes, call continues to CTA returned by IVR
 
@@ -360,45 +366,23 @@ webhook before proceeding further.
 
 To control flow of outgoing calls, use webhook IVR ID when placing an outbound call. See [Place Outgoing Cellular Call with Existing IVR](#place-outgoing-cellular-call-with-existing-ivr)
 
-See [examples/app.py](./examples/app.py) for working webhook examples.
+See [examples](https://github.com/jaxl-innovations-private-limited/jaxl-python/tree/main/examples) directory for working webhook examples.
 
 ### Realtime Streaming Audio
 
-Refer to [examples/app.py](./examples/app.py) for working streaming audio examples.
+Refer to [examples](https://github.com/jaxl-innovations-private-limited/jaxl-python/tree/main/examples) directory for working streaming audio examples.
 
 ### Realtime Streaming Speech Segments
 
-Refer to [examples/app.py](./examples/app.py) for working streaming speech segments examples.
+Refer to [examples](https://github.com/jaxl-innovations-private-limited/jaxl-python/tree/main/examples) directory for working streaming speech segments examples.
 
 ### Realtime Streaming Transcriptions per Speech Segment
 
-Refer to [examples/app.py](./examples/app.py) for working streaming transcription per speech segment examples.
+Refer to [examples](https://github.com/jaxl-innovations-private-limited/jaxl-python/tree/main/examples) directory for working streaming transcription per speech segment examples.
 
 ### AI Agent: Realtime Transcriptions STT ➡️ LLM/MCP ➡️ TTS
 
-Refer to [examples/app.py](./examples/app.py) for working AI Agent examples.
-
-```bash
-jaxl calls create \
-  --to "+91<Callee>"
-  --from "+91<Purchased Jaxl Number>" \
-  --transcribe
-```
-
-When `--pipeline` flag is used, Jaxl SDK will:
-
-- Start a local HTTP server for signaling
-- Starts [grout](https://github.com/abhinavsingh/proxy.py?tab=readme-ov-file#grout-ngrok-alternative) so that Jaxl servers can reach our signaling server
-- Pipeline framework will:
-  - Receive raw audio packets from callee and start to perform silence detection
-  - Starts STT conversion for detected speech segments
-  - Use local CPU (or GPUs if available for Silence detection & STT)
-  - Invokes pipeline module's `on_transcription` asynchronously as STT finishes
-
-Within our pipeline module we can then:
-
-- Feed transcription with prior knowledge base to LLM of choice e.g. ChatGPT, Ollama Models etc
-- Send back response from LLM back to the callee
+Refer to [examples](https://github.com/jaxl-innovations-private-limited/jaxl-python/tree/main/examples) directory for working AI Agent examples.
 
 ### List Subscriptions Payments
 
@@ -436,7 +420,7 @@ response = v1_calls_list.sync_detailed(
 )
 ```
 
-## Documentation
+## SDK Documentation
 
 ```
 # Clone this repository

jaxl_python-0.0.6/SPECIFICATION.md

@@ -0,0 +1,192 @@
+# Jaxl HTTP Webhook Specification
+
+Jaxl Apps are simply an implementation of Jaxl HTTP Webhook Specification. If you cannot use
+`jaxl-python` based apps, feel free to implement the below protocol in your existing HTTP
+services to build custom call flows.
+
+1. [Jaxl Webhook Requests](#requests)
+   - [Setup Event (1)](#setup-event-1)
+   - [Setup User Data Event (1)](#setup-user-data-event-1)
+   - [IVR Option Event (2)](#ivr-option-event-2)
+   - [IVR Option Data Event (2)](#ivr-option-data-event-2)
+   - [Teardown Event (3)](#teardown-event-3)
+2. [Jaxl Webhook Responses](#jaxl-webhook-responses)
+   - [Prompts](#prompts)
+     - [Prompt user to enter a numeric input followed by a star sign](#prompt-user-to-enter-a-numeric-input-followed-by-a-star-sign)
+     - [Prompt user to choose one of the option](#prompt-user-to-choose-one-of-the-option)
+     - [Speak and hangup](#speak-and-hangup)
+   - [CTAs](#ctas)
+     - [Send to phone](#send-to-phone)
+
+## Jaxl Webhook Requests
+
+### Setup Event (1)
+
+- Triggered when a call enters your Webhook/IVR Flow ID.
+- Webhook endpoint will receive following POST request:
+
+  ```json
+  {
+    "pk": "INTEGER-FLOW-ID",
+    "event": 1,
+    "state": {
+      "call_id": "INTEGER-CALL-ID",
+      "from_number": "+91XXXXXXXXXX",
+      "to_number": "+91YYYYYYYYYY",
+      "direction": 1,
+      "org": { "name": "Your Org Name As Registered With Jaxl Business Phone" },
+      "metadata": null,
+      "greeting_message": null
+    },
+    "option": null,
+    "data": null
+  }
+  ```
+
+### Setup User Data Event (1)
+
+- Triggered when setup prompts for user data via DTMF inputs
+
+  ```json
+  {
+    "pk": "INTEGER-FLOW-ID",
+    "event": 1,
+    "state": {
+      "call_id": "INTEGER-CALL-ID",
+      "from_number": "+91XXXXXXXXXX",
+      "to_number": "+91YYYYYYYYYY",
+      "direction": 1,
+      "org": { "name": "Your Org Name As Registered With Jaxl Business Phone" },
+      "metadata": null,
+      "greeting_message": null
+    },
+    "option": null,
+    "data": "123*"
+  }
+  ```
+
+### IVR Option Event (2)
+
+- Triggered when a single digit is received via DTMF input from the caller
+
+  ```json
+  {
+    "pk": "INTEGER-FLOW-ID",
+    "event": 2,
+    "state": {
+      "call_id": "INTEGER-CALL-ID",
+      "from_number": "+91XXXXXXXXXX",
+      "to_number": "+91YYYYYYYYYY",
+      "direction": 1,
+      "org": { "name": "Your Org Name As Registered With Jaxl Business Phone" },
+      "metadata": null,
+      "greeting_message": null
+    },
+    "option": "1",
+    "data": null
+  }
+  ```
+
+### IVR Option Data Event (2)
+
+- Triggered when data via DTMF inputs is received while within an IVR option
+
+  ```json
+  {
+    "pk": "INTEGER-FLOW-ID",
+    "event": 2,
+    "state": {
+      "call_id": "INTEGER-CALL-ID",
+      "from_number": "+91XXXXXXXXXX",
+      "to_number": "+91YYYYYYYYYY",
+      "direction": 1,
+      "org": { "name": "Your Org Name As Registered With Jaxl Business Phone" },
+      "metadata": null,
+      "greeting_message": null
+    },
+    "option": "1",
+    "data": "123*"
+  }
+  ```
+
+### Teardown Event (3)
+
+- Triggered when an incoming call ends.
+- Webhook endpoint will receive following POST request:
+
+  ```json
+  {
+    "pk": "INTEGER-FLOW-ID",
+    "event": 3,
+    "state": {
+      "call_id": "INTEGER-CALL-ID",
+      "from_number": "+91XXXXXXXXXX",
+      "to_number": "+91YYYYYYYYYY",
+      "direction": 1,
+      "org": { "name": "Your Org Name As Registered With Jaxl Business Phone" },
+      "metadata": null,
+      "greeting_message": null
+    },
+    "option": null,
+    "data": null
+  }
+  ```
+
+## Jaxl Webhook Responses
+
+You can return one of the following JSON objects as responses:
+
+### Prompts
+
+Prompts is a way to speak back to the user e.g.
+
+#### Prompt user to enter a numeric input followed by a star sign
+
+```json
+{
+  "prompt": ["Please enter your code followed by star sign"],
+  "num_characters": "*"
+}
+```
+
+#### Prompt user to choose one of the option
+
+```json
+{
+  "prompt": [
+    "You entered 657.",
+    "Press 1 to confirm.",
+    "Press 2 to re-enter your code."
+  ],
+  "num_characters": 1
+}
+```
+
+#### Speak and hangup
+
+```json
+{
+  "prompt": [
+    "Thank you for calling Jaxl Innovations Private Limited.",
+    "We are currently closed.",
+    "Our team will get back to you as soon as possible"
+  ],
+  "num_characters": 0
+}
+```
+
+### CTAs
+
+CTA objects are a way to tell the Jaxl system that no more user input is expected and sends user to provided CTA.
+
+#### Send to phone
+
+```json
+{
+  "next": null,
+  "phone": { "to_number": "+91XXXXXXXXXX", "from_number": null },
+  "devices": null,
+  "appusers": null,
+  "teams": null
+}
+```

jaxl_python-0.0.6/examples/README.md

@@ -0,0 +1,124 @@
+# Jaxl Python SDK Examples
+
+Jaxl SDK Apps implements [`BaseJaxlApp`](https://github.com/jaxl-innovations-private-limited/jaxl-python/blob/main/jaxl/api/base.py#L79) class. See `BaseJaxlApp` documentation for all possible lifecycle methods. Implement the lifecycle method you expect your custom call flows to hit.
+
+1. [Setup](#setup)
+   - [Development Setup](#development-setup)
+2. [Run](#run)
+   - [Grout for Development](#grout-for-development)
+   - [Webhook IVR](#webhook-ivr)
+3. [Examples](#examples)
+   - [Send To Phone](#send-to-phone)
+   - [Request Code and Send To Phone](#request-code-and-send-to-phone)
+   - [Request Code, Ask for Confirmation and Send To Phone](#request-code-ask-for-confirmation-and-send-to-phone)
+   - [Realtime Streaming Audio](#realtime-streaming-audio)
+   - [Realtime Streaming Speech Segments](#realtime-streaming-speech-segments)
+   - [Realtime Streaming Transcriptions per Speech Segment](#realtime-streaming-transcriptions-per-speech-segment)
+   - [AI Agent: Realtime Transcriptions STT ➡️ LLM/MCP ➡️ TTS](#ai-agent-realtime-transcriptions-stt-️-llmmcp-️-tts)
+4. [Production](#production)
+
+## Setup
+
+You must install `app` extras to build custom Jaxl SDK Apps.
+
+```bash
+pip install -U jaxl-python[app]
+```
+
+### Development Setup
+
+When developing locally on your laptops and desktops, you will also need to install `grout` extras. `Grout` is a drop-in replacement of `Ngrok` and likes, built by the team at Jaxl.
+
+```bash
+pip install -U jaxl-python[grout]
+```
+
+## Run
+
+```bash
+jaxl apps run --app <Module:ClassName>
+```
+
+### Grout for Development
+
+You will need to expose your IVR app publicly so that Jaxl servers can reach your app.
+
+In a separate terminal, start `grout` to get a public URL:
+
+```bash
+grout http://127.0.0.1:9919
+```
+
+### Webhook IVR
+
+Next go ahead and:
+
+1. [Create a webhook IVR](https://github.com/jaxl-innovations-private-limited/jaxl-python?tab=readme-ov-file#receive-call-events-via-webhook-ivrs). Use your public url as `--message`.
+2. [Assign a number to webhook IVR](https://github.com/jaxl-innovations-private-limited/jaxl-python?tab=readme-ov-file#assign-a-phone-number-to-ivr-by-id) app.
+
+## Examples
+
+`examples` python module contains variety of use cases for you to quickly get started. Copy and paste the provided examples in your own code base and modify as needed.
+
+- In example apps, `JAXL_SDK_PLACEHOLDER_CTA_PHONE` is only used for demonstration purposes.
+- In your Jaxl SDK production apps, you will likely fetch target phone number from your databases.
+
+```bash
+export JAXL_SDK_PLACEHOLDER_CTA_PHONE=+USE-A-REAL-NUMBER-HERE
+```
+
+### Send To Phone
+
+```bash
+PYTHONPATH=. jaxl apps run --app examples:JaxlAppSendToCellular
+```
+
+### Request Code and Send To Phone
+
+```bash
+PYTHONPATH=. jaxl apps run --app examples:JaxlAppRequestCodeAndSendToCellular
+```
+
+### Request Code, Ask for Confirmation and Send To Phone
+
+```bash
+PYTHONPATH=. jaxl apps run --app examples:JaxlAppConfirmRequestedCodeAndSendToCellular
+```
+
+### Realtime Streaming Audio
+
+```bash
+PYTHONPATH=. jaxl apps run --app examples:JaxlAppStreamingAudioChunk
+```
+
+### Realtime Streaming Speech Segments
+
+```bash
+PYTHONPATH=. jaxl apps run --app examples:JaxlAppStreamingSpeechSegment
+```
+
+### Realtime Streaming Transcriptions per Speech Segment
+
+```bash
+PYTHONPATH=. jaxl apps run --app examples:JaxlAppStreamingTranscription
+```
+
+### AI Agent: Realtime Transcriptions STT ➡️ LLM/MCP ➡️ TTS
+
+```bash
+PYTHONPATH=. jaxl apps run --app examples:JaxlAppStreamingAIAgent
+```
+
+## Production
+
+- In production, if not using grout, configure your load balancer to point to your Jaxl App instance IP:PORT service endpoint.
+
+- You can also continue using `grout` in production environments but we highly recommended to reserve a dedicated grout url for your Jaxl App. This will make sure your `grout` public URL remains consistent across restarts.
+
+  To reserve a `grout` url simply provide a custom URL to use e.g.
+
+  ```bash
+  grout http://127.0.0.1:9919 https://my-company-delivery-driver-app.jaxl.io
+  ```
+
+  For more instructions and dedicated domain setup refer to `Grout` documentation