​

AG-UI Dart SDK

dart pub add ag_ui

​

Key Features

• Type-Safe Events: Strongly typed event system with compile-time safety
• Reactive Streams: Built on Dart’s native Stream API for efficient async operations
• SSE Support: Full Server-Sent Events implementation with automatic reconnection
• Binary Protocol: Efficient binary encoding/decoding for optimal performance
• Flutter Ready: Designed for seamless integration with Flutter applications
• Error Handling: Comprehensive error handling with retry strategies

​

Quick Start

import 'package:ag_ui/ag_ui.dart';

void main() async {
  // Create client
  final client = AgUiClient(
    config: AgUiClientConfig(
      baseUrl: 'http://localhost:8000',
    ),
  );

  // Prepare input
  final input = SimpleRunAgentInput(
    messages: [
      UserMessage(id: 'msg_1', content: 'Hello, agent!'),
    ],
  );

  // Stream events
  await for (final event in client.runAgent('my-agent', input)) {
    switch (event) {
      case TextMessageStartedEvent():
        print('Assistant started typing...');
      case TextMessageDeltaEvent(delta: final delta):
        print('Assistant: $delta');
      case ToolCallStartedEvent(name: final name):
        print('Calling tool: $name');
      default:
        print('Event: ${event.type}');
    }
  }
}

​

Architecture

​

Core Components

​

Installation

​

Dart Projects

dependencies:
  ag_ui: ^1.0.0

dart pub get

​

Flutter Projects

flutter pub add ag_ui

​

Platform Support

• Flutter: iOS, Android, Web, Desktop (Windows, macOS, Linux)
• Dart VM: Server-side and CLI applications
• Dart Web: Browser-based applications

​

Example Application

• CLI Tool: Interactive command-line tool demonstrating:
  • Basic agent conversation
  • Tool-based generative UI flow
  • Server-Sent Events streaming
  • Auto-tool mode for non-interactive execution
  • JSON output for debugging
  • Error handling and retry logic

​

Testing

# Run all tests
dart test

# Run with coverage
dart test --coverage=coverage

# Run specific test file
dart test test/client/client_test.dart

​

Contributing

​

License