marona 0.2.0

Official Dart client SDK for Marona-compatible AI runtimes and Hub integrations.

marona

Official Dart client for Marona-compatible hybrid AI runtimes and Marona Hub.

Use it from Flutter apps, Dart backends, desktop apps, wearable interfaces, or any client that needs one API for cloud, local, and hybrid AI execution.

Install

dependencies:
  marona: ^0.2.0

Create A Client

import 'package:marona/marona.dart';

final marona = Marona(
  apiKey: 'mrn_live_...',
  mode: 'hybrid',
);

Modes:

• online: use Marona cloud runtime and online app routes.
• offline: use only local cache, local models, and local app routes.
• hybrid: prefer local resources, then fall back online when allowed.

Send A Message

final response = await marona.message(
  'Create a PowerPoint about AI introduction',
  interfaceName: 'mobile_app',
  conversationId: 'demo',
);

print(response.text);

Sync And Connect Apps

await marona.sync();

final tools = await marona.hub.connect(
  ['billing-mcp', 'network-mcp'],
  adapter: 'tools',
);

Marona resolves apps from local cache first. Offline mode uses only local app routes. Online and hybrid modes can refresh from Hub.

Register A Local Or Cloud Model

await marona.models.register(
  name: 'office-model',
  endpoint: 'http://localhost:9379',
);

marona.models.use('office-model');

Developers do not need to specify provider, backend type, or capabilities. Marona detects model features internally and routes by execution mode.

Smart Glasses / Wearables

final response = await marona.message(
  'What am I looking at?',
  interfaceName: 'wearable',
  clientCapabilities: const ClientCapabilities(
    clientType: 'wearable',
    supports: {'voice': true, 'camera': true, 'screen': true},
    constraints: {'screen_size': 'tiny', 'interaction': 'voice'},
  ),
);

Package Names

• Dart client: marona, import package:marona/marona.dart
• Python client: marona, import marona
• TypeScript client: marona, import Marona from "marona"
• Developer SDK for building apps: marona-sdk