flutter_adk #

English | 한국어 | 日本語 | 中文

Flutter facade package for ADK Dart core runtime.

What This Package Provides #

• Re-exports package:adk_dart/adk_core.dart so Flutter apps can use the Web-safe ADK surface through package:flutter_adk/flutter_adk.dart.
• Exposes core runtime APIs needed for Flutter app usage:
  • Agent / LlmAgent
  • SequentialAgent / ParallelAgent / LoopAgent
  • Runner / InMemoryRunner
  • FunctionTool
  • McpToolset (remote MCP over Streamable HTTP)
  • SkillToolset + inline Skill
  • Gemini (BYOK-style key injection)
• Includes a Flutter plugin scaffold registered for all major Flutter platforms:
  • Android
  • iOS
  • Web
  • Linux
  • macOS
  • Windows

When To Use flutter_adk #

Use flutter_adk when:

• You are building a Flutter app and want one import that works across mobile, desktop, and web.
• You want the web-safe ADK runtime surface (adk_core) without pulling in VM-only APIs by default.

Use another package when:

• You are building VM/CLI agents, tools, or servers: use adk_dart (or adk for shorter imports).

Design intent:

• flutter_adk is not just a wrapper name; it is the Flutter-oriented compatibility layer.
• It prioritizes consistent multi-platform behavior in Flutter by exposing the web-safe runtime surface (adk_core) instead of the full VM-only API set.

Package Links #

• flutter_adk: Flutter-focused package for web-safe ADK usage across Flutter platforms.
• adk_dart: Core runtime package with the full ADK Dart VM/CLI API surface.
• adk: Short-name facade package that re-exports adk_dart.

Usage #

import 'package:flutter_adk/flutter_adk.dart';

void main() {
  final Session session = Session(id: 's1', appName: 'app', userId: 'u1');
  final InMemorySessionService sessions = InMemorySessionService();
  print('${session.id}:${sessions.runtimeType}');
}

Full Runtime Surface #

• For VM/CLI-only APIs, import package:adk_dart/adk_dart.dart.

Platform Scope (Current) #

• flutter_adk is a Flutter-focused runtime surface built on top of adk_core.
• It targets single-import usage across Flutter platforms while leaving VM/CLI-only APIs outside this package.

Status legend:

• Y Supported
• Partial Supported with caveats
• N Not supported

Reference matrix and rollout notes:

• knowledge/2026-03-01_18-20-00_flutter_adk_platform_support_matrix.md

Limitations #

• Features requiring dart:io, dart:ffi, or dart:mirrors are outside the current flutter_adk surface.
• MCP stdio transport (StdioConnectionParams) is not supported on Web.
• Directory-based skill loading (loadSkillFromDir) is not supported on Web. Use inline Skill definitions.
• For browser BYOK (user-entered API key), document security risks before production rollout.