Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+orchestrix-actions.task filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,226 @@
+---
+language:
+- en
+license: gemma
+library_name: mediapipe
+tags:
+- gemma
+- function-calling
+- ui-control
+- flutter
+- on-device
+- fine-tuned
+- mobile-ai
+base_model: google/functiongemma-270m-it
+datasets:
+- custom
+pipeline_tag: text-generation
+---
+
+# Orchestrix
+
+**Orchestrix** is a fine-tuned **FunctionGemma 270M** model designed for **on-device UI orchestration** using **function calling**.  
+It converts natural language commands into **deterministic UI actions**, running fully **offline** via MediaPipe.
+
+
+## Model Description
+
+This is a fine-tuned version of **FunctionGemma 270M Instruct** specifically trained for natural language-based UI control through function calling. The model interprets user commands and generates structured function calls to manipulate application UI elements.
+
+**Base Model**: `google/functiongemma-270m-it`  
+**Fine-tuning Task**: Function calling for UI control  
+**Format**: MediaPipe Task file (`.task`)  
+**Deployment**: On-device inference via Flutter
+
+## Intended Use
+
+### Primary Use Cases
+
+- **Mobile/Desktop Applications**: Natural language UI control in Flutter apps
+- **On-Device AI**: Privacy-focused, offline AI interactions
+- **Function Calling**: Demonstrating LLM tool use capabilities
+- **Accessibility**: Voice-controlled UI modifications
+
+### Supported Functions
+
+The model is trained to call the following functions:
+
+| Function | Description | Parameters |
+|----------|-------------|------------|
+| `change_theme` | Switch app theme | `theme`: "light", "dark", or "system" |
+| `change_background_color` | Modify background color | `color`: "red", "blue", "green", "black", "white", "yellow", "purple", "orange" |
+| `change_text_color` | Change text color | `color`: "white" or "black" |
+| `change_text_size` | Adjust text size | `size`: "small", "medium", or "large" |
+
+## Training Details
+
+### Training Data
+
+The model was fine-tuned on a custom dataset of ~1000 examples mapping natural language commands to function calls. Training data format:
+
+```json
+{
+  "messages": [
+    {
+      "role": "user",
+      "content": "Make the background blue"
+    },
+    {
+      "role": "assistant",
+      "tool_calls": [
+        {
+          "name": "change_background_color",
+          "arguments": {"color": "blue"}
+        }
+      ]
+    }
+  ]
+}
+```
+
+### Training Procedure
+
+- **Base Model**: FunctionGemma 270M Instruct
+- **Fine-tuning Method**: Supervised fine-tuning on function calling examples
+- **Training Examples**: ~1000 user command → function call pairs
+- **Optimization**: Focused on accurate function name and parameter extraction
+
+### Training Hyperparameters
+
+- **Learning Rate**: [Your learning rate]
+- **Batch Size**: [Your batch size]
+- **Epochs**: [Number of epochs]
+- **Max Sequence Length**: [Your max length]
+
+> **Note**: Update the hyperparameters section with your actual training configuration.
+
+## Usage
+
+### Flutter Integration
+
+```dart
+import 'package:flutter_gemma/flutter_gemma.dart';
+
+// Initialize Flutter Gemma
+await FlutterGemma.initialize();
+
+// Install the model
+
+// Create model instance
+final model = await FlutterGemma.getActiveModel(
+  maxTokens: 1024,
+  preferredBackend: PreferredBackend.cpu,
+);
+
+// Define tools (must match training data)
+final tools = [
+  Tool(
+    name: 'change_theme',
+    description: 'Change application theme',
+    parameters: {
+      'type': 'object',
+      'properties': {
+        'theme': {
+          'type': 'string',
+          'enum': ['light', 'dark', 'system'],
+        },
+      },
+      'required': ['theme'],
+    },
+  ),
+  // ... other tools
+];
+
+// Create chat session
+final chat = await model.createChat(
+  tools: tools,
+  supportsFunctionCalls: true,
+);
+
+// Send user message
+await chat.sendMessage('Switch to dark mode');
+```
+
+### Example Interactions
+
+**Example 1: Theme Change**
+```
+User: "Switch to dark mode"
+Model Output: {
+  "tool_calls": [{
+    "name": "change_theme",
+    "arguments": {"theme": "dark"}
+  }]
+}
+```
+
+**Example 2: Color Change**
+```
+User: "Make the background purple"
+Model Output: {
+  "tool_calls": [{
+    "name": "change_background_color",
+    "arguments": {"color": "purple"}
+  }]
+}
+```
+
+**Example 3: Multiple Commands**
+```
+User: "Change to dark theme and make text large"
+Model Output: {
+  "tool_calls": [
+    {
+      "name": "change_theme",
+      "arguments": {"theme": "dark"}
+    },
+    {
+      "name": "change_text_size",
+      "arguments": {"size": "large"}
+    }
+  ]
+}
+```
+
+## Performance
+
+### Accuracy Metrics
+
+- **Function Name Accuracy**: [Your accuracy]%
+- **Parameter Accuracy**: [Your accuracy]%
+- **Multi-function Handling**: [Your accuracy]%
+
+> **Note**: Update with your evaluation metrics.
+
+
+## Limitations
+
+1. **Limited Function Set**: Only supports 4 predefined functions
+2. **Parameter Constraints**: Parameters are restricted to predefined enums
+3. **Language**: English only
+4. **Context**: Optimized for UI control tasks, not general conversation
+5. **Ambiguity**: May struggle with highly ambiguous or complex commands
+
+## Bias and Ethical Considerations
+
+- The model is trained on synthetic data and may not represent diverse user populations
+- Function calling is deterministic and limited to safe UI operations
+- No personal data is collected or transmitted (fully on-device)
+
+## Model Card Authors
+
+Vijay K
+
+## Model Card Contact
+
+For questions or issues, please contact: [vijaykatmail@gmail.com](mailto:vijaykatmail@gmail.com)
+
+## License
+
+This model is released under the [Gemma License](https://ai.google.dev/gemma/terms).
+
+## Acknowledgments
+
+- **Google DeepMind** for the Gemma base model
+- **MediaPipe** for on-device inference capabilities
+- **Flutter Gemma** package maintainers

orchestrix-actions.model

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:aa009fcbc3589a9904d30d04834094fea4653c2ac6d2de2cd1262d4f7a50ceb3
+size 4689144

orchestrix-actions.task

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ea996aebc96d0cecb27df579db40e6c6ae91ebe04580d734e22e07e173246b23
+size 284368286

orchestrix-actions.tflite

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7ca94da95b73d139eaebc2b2832e6ff93ea68e17db7b0c54478e4b0e53064486
+size 279678744

prompt/prompt.txt

@@ -0,0 +1,77 @@
+<start_of_turn>developer
+You are a model that can do function calling with the following functions.
+
+<start_function_declaration>
+declaration:change_theme{
+description:<escape>Change application theme<escape>,
+parameters:{
+properties:{
+theme:{
+description:<escape>Theme mode<escape>,
+enum:[<escape>light<escape>,<escape>dark<escape>,<escape>system<escape>],
+type:<escape>STRING<escape>
+}
+},
+required:[<escape>theme<escape>],
+type:<escape>OBJECT<escape>
+}
+}
+<end_function_declaration>
+
+<start_function_declaration>
+declaration:change_background_color{
+description:<escape>Change background color<escape>,
+parameters:{
+properties:{
+color:{
+description:<escape>Background color<escape>,
+enum:[<escape>red<escape>,<escape>blue<escape>,<escape>green<escape>,<escape>black<escape>,<escape>white<escape>],
+type:<escape>STRING<escape>
+}
+},
+required:[<escape>color<escape>],
+type:<escape>OBJECT<escape>
+}
+}
+<end_function_declaration>
+
+<start_function_declaration>
+declaration:change_text_color{
+description:<escape>Change text color<escape>,
+parameters:{
+properties:{
+color:{
+description:<escape>Text color<escape>,
+enum:[<escape>white<escape>,<escape>black<escape>],
+type:<escape>STRING<escape>
+}
+},
+required:[<escape>color<escape>],
+type:<escape>OBJECT<escape>
+}
+}
+<end_function_declaration>
+
+<start_function_declaration>
+declaration:change_text_size{
+description:<escape>Change text size<escape>,
+parameters:{
+properties:{
+size:{
+description:<escape>Text size<escape>,
+enum:[<escape>small<escape>,<escape>medium<escape>,<escape>large<escape>],
+type:<escape>STRING<escape>
+}
+},
+required:[<escape>size<escape>],
+type:<escape>OBJECT<escape>
+}
+}
+<end_function_declaration>
+
+You must respond ONLY with a function call when the user intent matches a function.
+Do not explain.
+Do not ask questions.
+Do not output JSON.
+Do not include text outside function calls.
+<end_of_turn>