dependencies:
  runanywhere: ^0.20.11
  runanywhere_llamacpp: ^0.20.11

dependencies:
  runanywhere: ^0.20.11
  runanywhere_onnx: ^0.20.11

dependencies:
  runanywhere: ^0.20.11
  runanywhere_mlx: ^0.20.11

dependencies:
  runanywhere: ^0.20.11
  runanywhere_llamacpp: ^0.20.11
  runanywhere_mlx: ^0.20.11
  runanywhere_onnx: ^0.20.11

flutter pub get

# Set minimum iOS version to 17.5
platform :ios, '17.5'

target 'Runner' do
  # REQUIRED: Add static linkage
  use_frameworks! :linkage => :static

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '17.5'
      # Required for microphone permission (STT/Voice features)
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',
        'PERMISSION_MICROPHONE=1',
      ]
    end
  end
end

<key>NSMicrophoneUsageDescription</key>
<string>This app needs microphone access for speech recognition</string>

cd ios && pod install && cd ..

<uses-permission android:name="android.permission.RECORD_AUDIO" />

import 'package:runanywhere/runanywhere.dart';
import 'package:runanywhere_llamacpp/runanywhere_llamacpp.dart';
import 'package:runanywhere_mlx/runanywhere_mlx.dart';
import 'package:runanywhere_onnx/runanywhere_onnx.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 1. Register backend modules before SDK initialization
  LlamaCpp.register();        // LLM backend (GGUF models)
  await MLX.register();       // Apple MLX backend (physical iOS device only)
  await Onnx.register();      // STT/TTS backend (Whisper, Piper)

  // 2. Initialize SDK (development mode - no API key needed)
  await RunAnywhere.initialize();

  print('RunAnywhere SDK initialized: v${RunAnywhere.version}');

  runApp(const MyApp());
}

// Register an LLM model
RunAnywhere.models.register(
  id: 'smollm2-360m-q8_0',
  name: 'SmolLM2 360M Q8_0',
  url: Uri.parse('https://huggingface.co/prithivMLmods/SmolLM2-360M-GGUF/resolve/main/SmolLM2-360M.Q8_0.gguf'),
  framework: InferenceFramework.INFERENCE_FRAMEWORK_LLAMA_CPP,
  memoryRequirement: 500000000,
);

// Register an STT model
RunAnywhere.models.register(
  id: 'sherpa-onnx-whisper-tiny.en',
  name: 'Whisper Tiny English',
  url: Uri.parse('https://github.com/RunanywhereAI/sherpa-onnx/releases/download/runanywhere-models-v1/sherpa-onnx-whisper-tiny.en.tar.gz'),
  framework: InferenceFramework.INFERENCE_FRAMEWORK_SHERPA,
  modality: ModelCategory.MODEL_CATEGORY_SPEECH_RECOGNITION,
);

// Register a TTS voice
RunAnywhere.models.register(
  id: 'vits-piper-en_US-lessac-medium',
  name: 'Piper US English',
  url: Uri.parse('https://github.com/RunanywhereAI/sherpa-onnx/releases/download/runanywhere-models-v1/vits-piper-en_US-lessac-medium.tar.gz'),
  framework: InferenceFramework.INFERENCE_FRAMEWORK_SHERPA,
  modality: ModelCategory.MODEL_CATEGORY_SPEECH_SYNTHESIS,
);

// Download with progress
final progressStream = RunAnywhere.downloads.start('smollm2-360m-q8_0');
await for (final p in progressStream) {
  print('Stage: ${p.stage}, progress: ${(p.stageProgress * 100).toStringAsFixed(1)}%');
  if (p.stage == DownloadStage.DOWNLOAD_STAGE_COMPLETED) break;
}

// Load the model
await RunAnywhere.llm.load('smollm2-360m-q8_0');
print('Model loaded: ${RunAnywhere.isLLMModelLoaded}');

// Non-streaming with full metrics
final result = await RunAnywhere.llm.generate(
  'Explain quantum computing in simple terms',
  LLMGenerationOptions(
    maxTokens: 200,
    temperature: 0.7,
  ),
);
print('Response: ${result.text}');
print('Speed: ${result.tokensPerSecond.toStringAsFixed(1)} tok/s');

final stream = RunAnywhere.llm.generateStream(
  'Write a short poem about AI',
  LLMGenerationOptions(maxTokens: 150),
);

// Display tokens in real-time
await for (final event in stream) {
  if (event.isFinal) break;
  if (event.token.isNotEmpty) {
    stdout.write(event.token);
  }
}

// Load STT model
await RunAnywhere.stt.load('sherpa-onnx-whisper-tiny.en');

// Transcribe audio data (PCM16 at 16kHz mono)
final result = await RunAnywhere.stt.transcribe(audioBytes);
print('Text: ${result.text}');
print('Confidence: ${result.confidence}');

// Load TTS voice
await RunAnywhere.tts.loadVoice('vits-piper-en_US-lessac-medium');

// Synthesize speech
final ttsResult = await RunAnywhere.tts.synthesize(
  'Hello! Welcome to RunAnywhere.',
  TTSOptions(rate: 1.0, pitch: 1.0),
);
// ttsResult.audio is Uint8List PCM16
// ttsResult.sampleRate is typically 22050 Hz

// Ensure all components are loaded
await RunAnywhere.stt.load('sherpa-onnx-whisper-tiny.en');
await RunAnywhere.llm.load('smollm2-360m-q8_0');
await RunAnywhere.tts.loadVoice('vits-piper-en_US-lessac-medium');

// Initialize voice pipeline with the loaded models
await RunAnywhere.voice.initializeWithLoadedModels();

// Subscribe to the voice event stream
final sub = RunAnywhere.voice.eventStream().listen((event) {
  if (event.hasUserSaid()) {
    print('User: ${event.userSaid.text}');
  } else if (event.hasAssistantToken()) {
    stdout.write(event.assistantToken.text);
  }
});

// Cancel when done
await sub.cancel();

┌─────────────────────────────────────────────────────────────────┐
│                      Your Flutter Application                     │
├─────────────────────────────────────────────────────────────────┤
│                    RunAnywhere Flutter SDK                        │
│  ┌──────────────┐  ┌───────────────┐  ┌──────────────────────┐  │
│  │ Public APIs  │  │  EventBus     │  │  ModelRegistry       │  │
│  │ (generate,   │  │  (events,     │  │  (model discovery,   │  │
│  │  transcribe) │  │   lifecycle)  │  │   download)          │  │
│  └──────────────┘  └───────────────┘  └──────────────────────┘  │
├─────────────────────────────────────────────────────────────────┤
│                    Native Bridge Layer (FFI)                      │
│                  DartBridge → C++ Commons APIs                    │
├───────────┬───────────┬───────────┬─────────────────────────────┤
│ LlamaCpp  │ Apple MLX │   ONNX    │ QHexRT (Android/Snapdragon) │
│ LLM + VLM │ LLM, VLM, │ STT, TTS, │ LLM, VLM, STT, TTS         │
│           │ embed,     │ VAD       │                             │
│           │ STT, TTS   │           │                             │
└───────────┴───────────┴───────────┴─────────────────────────────┘

// Development mode (default) - no API key needed
await RunAnywhere.initialize();

// Production mode - requires API key and backend URL
await RunAnywhere.initialize(
  apiKey: '<YOUR_API_KEY>',
  baseURL: 'https://api.runanywhere.ai',
  environment: SDKEnvironment.SDK_ENVIRONMENT_PRODUCTION,
);

final options = LLMGenerationOptions(
  maxTokens: 256,              // Maximum tokens to generate
  temperature: 0.7,            // Sampling temperature (0.0–2.0)
  topP: 0.95,                  // Top-p sampling parameter
  stopSequences: ['END'],      // Stop generation at these sequences
  systemPrompt: 'You are a helpful assistant.',
);

try {
  final result = await RunAnywhere.llm.generate(
    'Hello!',
    LLMGenerationOptions(maxTokens: 64),
  );
} on SDKException catch (error) {
  // SDKException is a proto-backed unified error type with 40+ factory constructors.
  // Inspect error.message and error.errorCode (proto enum) to branch.
  print('SDK error [${error.errorCode}]: ${error.message}');
}

// Subscribe to all SDK events
RunAnywhere.events.allEvents.listen((event) {
  print('Event: $event');
});

// Unload models when not in use
await RunAnywhere.llm.unload();
await RunAnywhere.stt.unload();
await RunAnywhere.tts.unloadVoice();

// Check storage before downloading
final storageInfo = await RunAnywhere.downloads.getStorageInfo();
print('Available: ${storageInfo.freeBytes} bytes');

// Delete unused models
await RunAnywhere.downloads.delete('old-model-id');

# 1. Clone the repository
git clone https://github.com/RunanywhereAI/runanywhere-sdks.git
cd runanywhere-sdks

# 2. Build the native artifacts (from repo root)
./sdk/runanywhere-swift/scripts/build-core-xcframework.sh                # iOS XCFrameworks
./scripts/build/build-core-android.sh arm64-v8a          # Android .so files

# 3. Bootstrap the Flutter workspace
cd sdk/runanywhere-flutter
melos bootstrap

# 1. Ensure SDK is set up (from previous step)

# 2. Navigate to the sample app
cd ../../examples/flutter/RunAnywhereAI

# 3. Install dependencies
flutter pub get

# 4. Run on iOS
cd ios && pod install && cd ..
flutter run

# 5. Or run on Android
flutter run

Sample App → Local Flutter SDK Packages → Local Frameworks/JNI libs
                                                ↑
                               Built by scripts/build/build-core-*.sh

# From repo root
./sdk/runanywhere-swift/scripts/build-core-xcframework.sh
./scripts/build/build-core-android.sh arm64-v8a

# Format code
dart format lib/ test/

# Analyze code
flutter analyze

# Fix issues automatically
dart fix --apply