arduino · mirkoCrobu · Dec 3, 2025 · Dec 3, 2025
diff --git a/Taskfile.yml b/Taskfile.yml
@@ -8,8 +8,8 @@ vars:
   GOLANGCI_LINT_VERSION: v2.4.0
   GOIMPORTS_VERSION: v0.29.0
   DPRINT_VERSION: 0.48.0
-  EXAMPLE_VERSION: "0.5.1"
-  RUNNER_VERSION: "0.5.0"
+  EXAMPLE_VERSION: "0.6.0"
+  RUNNER_VERSION: "0.6.0"
   VERSION: # if version is not passed we hack the semver by encoding the commit as pre-release
     sh: echo "${VERSION:-0.0.0-$(git rev-parse --short HEAD)}"
 

diff --git a/...share/arduino-app-cli/assets/0.5.0/api-docs/arduino/app_bricks/cloud_llm/API.md b/...share/arduino-app-cli/assets/0.5.0/api-docs/arduino/app_bricks/cloud_llm/API.md
diff --git a/.../app_bricks/air_quality_monitoring/API.md → .../app_bricks/air_quality_monitoring/API.md b/.../app_bricks/air_quality_monitoring/API.md → .../app_bricks/air_quality_monitoring/API.md
diff --git a/...s/arduino/app_bricks/arduino_cloud/API.md → ...s/arduino/app_bricks/arduino_cloud/API.md b/...s/arduino/app_bricks/arduino_cloud/API.md → ...s/arduino/app_bricks/arduino_cloud/API.md
diff --git a/...no/app_bricks/audio_classification/API.md → ...no/app_bricks/audio_classification/API.md b/...no/app_bricks/audio_classification/API.md → ...no/app_bricks/audio_classification/API.md
@@ -67,7 +67,7 @@ Stop real-time audio classification.
 
 Terminates audio capture and releases any associated resources.
 
-#### `classify_from_file(audio_path: str, confidence: int)`
+#### `classify_from_file(audio_path: str, confidence: float)`
 
 Classify audio content from a WAV file.
 
@@ -80,9 +80,8 @@ Supported sample widths:
 ##### Parameters
 
 - **audio_path** (*str*): Path to the `.wav` audio file to classify.
-- **confidence** (*int*) (optional): Confidence threshold (0–1). If None,
-the default confidence level specified during initialization
-will be applied.
+- **confidence** (*float*) (optional): Minimum confidence threshold (0.0–1.0) required
+for a detection to be considered valid. Defaults to 0.8 (80%).
 
 ##### Returns
 

diff --git a/...o/app_bricks/camera_code_detection/API.md → ...o/app_bricks/camera_code_detection/API.md b/...o/app_bricks/camera_code_detection/API.md → ...o/app_bricks/camera_code_detection/API.md
diff --git a/...share/arduino-app-cli/assets/0.6.0/api-docs/arduino/app_bricks/cloud_llm/API.md b/...share/arduino-app-cli/assets/0.6.0/api-docs/arduino/app_bricks/cloud_llm/API.md
@@ -0,0 +1,120 @@
+# cloud_llm API Reference
+
+## Index
+
+- Class `CloudLLM`
+- Class `CloudModel`
+
+---
+
+## `CloudLLM` class
+
+```python
+class CloudLLM(api_key: str, model: Union[str, CloudModel], system_prompt: str, temperature: Optional[float], timeout: int)
+```
+
+A Brick for interacting with cloud-based Large Language Models (LLMs).
+
+This class wraps LangChain functionality to provide a simplified, unified interface
+for chatting with models like Claude, GPT, and Gemini. It supports both synchronous
+'one-shot' responses and streaming output, with optional conversational memory.
+
+### Parameters
+
+- **api_key** (*str*): The API access key for the target LLM service. Defaults to the
+'API_KEY' environment variable.
+- **model** (*Union[str, CloudModel]*): The model identifier. Accepts a `CloudModel`
+enum member (e.g., `CloudModel.OPENAI_GPT`) or its corresponding raw string
+value (e.g., `'gpt-4o-mini'`). Defaults to `CloudModel.ANTHROPIC_CLAUDE`.
+- **system_prompt** (*str*): A system-level instruction that defines the AI's persona
+and constraints (e.g., "You are a helpful assistant"). Defaults to empty.
+- **temperature** (*Optional[float]*): The sampling temperature between 0.0 and 1.0.
+Higher values make output more random/creative; lower values make it more
+deterministic. Defaults to 0.7.
+- **timeout** (*int*): The maximum duration in seconds to wait for a response before
+timing out. Defaults to 30.
+
+### Raises
+
+- **ValueError**: If `api_key` is not provided (empty string).
+
+### Methods
+
+#### `with_memory(max_messages: int)`
+
+Enables conversational memory for this instance.
+
+Configures the Brick to retain a window of previous messages, allowing the
+AI to maintain context across multiple interactions.
+
+##### Parameters
+
+- **max_messages** (*int*): The maximum number of messages (user + AI) to keep
+in history. Older messages are discarded. Set to 0 to disable memory.
+Defaults to 10.
+
+##### Returns
+
+- (*CloudLLM*): The current instance, allowing for method chaining.
+
+#### `chat(message: str)`
+
+Sends a message to the AI and blocks until the complete response is received.
+
+This method automatically manages conversation history if memory is enabled.
+
+##### Parameters
+
+- **message** (*str*): The input text prompt from the user.
+
+##### Returns
+
+- (*str*): The complete text response generated by the AI.
+
+##### Raises
+
+- **RuntimeError**: If the internal chain is not initialized or if the API request fails.
+
+#### `chat_stream(message: str)`
+
+Sends a message to the AI and yields response tokens as they are generated.
+
+This allows for processing or displaying the response in real-time (streaming).
+The generation can be interrupted by calling `stop_stream()`.
+
+##### Parameters
+
+- **message** (*str*): The input text prompt from the user.
+
+##### Returns
+
+- (*str*): Chunks of text (tokens) from the AI response.
+
+##### Raises
+
+- **RuntimeError**: If the internal chain is not initialized or if the API request fails.
+- **AlreadyGenerating**: If a streaming session is already active.
+
+#### `stop_stream()`
+
+Signals the active streaming generation to stop.
+
+This sets an internal flag that causes the `chat_stream` iterator to break
+early. It has no effect if no stream is currently running.
+
+#### `clear_memory()`
+
+Clears the conversational memory history.
+
+Resets the stored context. This is useful for starting a new conversation
+topic without previous context interfering. Only applies if memory is enabled.
+
+
+---
+
+## `CloudModel` class
+
+```python
+class CloudModel()
+```
+
diff --git a/...uino/app_bricks/dbstorage_sqlstore/API.md → ...uino/app_bricks/dbstorage_sqlstore/API.md b/...uino/app_bricks/dbstorage_sqlstore/API.md → ...uino/app_bricks/dbstorage_sqlstore/API.md
diff --git a/...duino/app_bricks/dbstorage_tsstore/API.md → ...duino/app_bricks/dbstorage_tsstore/API.md b/...duino/app_bricks/dbstorage_tsstore/API.md → ...duino/app_bricks/dbstorage_tsstore/API.md
diff --git a/...no/app_bricks/image_classification/API.md → ...no/app_bricks/image_classification/API.md b/...no/app_bricks/image_classification/API.md → ...no/app_bricks/image_classification/API.md
diff --git a/...rduino/app_bricks/keyword_spotting/API.md → ...rduino/app_bricks/keyword_spotting/API.md b/...rduino/app_bricks/keyword_spotting/API.md → ...rduino/app_bricks/keyword_spotting/API.md
diff --git a/...s/arduino/app_bricks/mood_detector/API.md → ...s/arduino/app_bricks/mood_detector/API.md b/...s/arduino/app_bricks/mood_detector/API.md → ...s/arduino/app_bricks/mood_detector/API.md
diff --git a/...rduino/app_bricks/motion_detection/API.md → ...rduino/app_bricks/motion_detection/API.md b/...rduino/app_bricks/motion_detection/API.md → ...rduino/app_bricks/motion_detection/API.md
diff --git a/...0/api-docs/arduino/app_bricks/mqtt/API.md → ...0/api-docs/arduino/app_bricks/mqtt/API.md b/...0/api-docs/arduino/app_bricks/mqtt/API.md → ...0/api-docs/arduino/app_bricks/mqtt/API.md
diff --git a/...rduino/app_bricks/object_detection/API.md → ...rduino/app_bricks/object_detection/API.md b/...rduino/app_bricks/object_detection/API.md → ...rduino/app_bricks/object_detection/API.md
@@ -19,6 +19,14 @@ This module processes an input image and returns:
 - Corresponding class labels
 - Confidence scores for each detection
 
+### Parameters
+
+- **confidence** (*float*): Minimum confidence threshold for detections. Default is 0.3 (30%).
+
+### Raises
+
+- **ValueError**: If model information cannot be retrieved.
+
 ### Methods
 
 #### `detect_from_file(image_path: str, confidence: float)`
@@ -60,7 +68,7 @@ Draw bounding boxes on an image enclosing detected objects using PIL.
 ##### Returns
 
 -: Image with bounding boxes and key points drawn.
-None if no detection or invalid image.
+None if input image or detections are invalid.
 
 #### `process(item)`
 

diff --git a/...cs/arduino/app_bricks/streamlit_ui/API.md → ...cs/arduino/app_bricks/streamlit_ui/API.md b/...cs/arduino/app_bricks/streamlit_ui/API.md → ...cs/arduino/app_bricks/streamlit_ui/API.md
diff --git a/...bricks/vibration_anomaly_detection/API.md → ...bricks/vibration_anomaly_detection/API.md b/...bricks/vibration_anomaly_detection/API.md → ...bricks/vibration_anomaly_detection/API.md
diff --git a/...p_bricks/video_imageclassification/API.md → ...p_bricks/video_imageclassification/API.md b/...p_bricks/video_imageclassification/API.md → ...p_bricks/video_imageclassification/API.md
diff --git a/...o/app_bricks/video_objectdetection/API.md → ...o/app_bricks/video_objectdetection/API.md b/...o/app_bricks/video_objectdetection/API.md → ...o/app_bricks/video_objectdetection/API.md
diff --git a/...pp_bricks/visual_anomaly_detection/API.md → ...pp_bricks/visual_anomaly_detection/API.md b/...pp_bricks/visual_anomaly_detection/API.md → ...pp_bricks/visual_anomaly_detection/API.md