v-modal/vmodal_sdk_flutter

AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它通过类型化的原生 Flutter API 支持基于自然语言、语音、文字和图像的多模态视频搜索，并提供流式上传和完整的取消机制。

适合谁使用

Flutter 移动端开发者
构建视频类应用的开发者
需要多模态搜索功能的团队
需要自主管理应用凭据的开发者

典型使用场景

通过语音或屏幕文字搜索视频中的片段（ASR/OCR）
使用自然语言查询视频中的视觉内容
从设备存储或相机上传视频，并实时查看进度及取消上传
在不添加登录界面下，将多模态搜索集成到现有 Flutter 应用

项目优势

类型化的小型 Dart API，包含专注的资源类（auth、searches、collections 等）
流式上传，避免将整个文件加载到内存
支持按操作取消令牌，便于可靠的生命周期管理
应用拥有运行时凭据，无需强加登录界面

使用前须知

当前版本不支持 Flutter Web
分片上传为实验性功能，需要显式启用
要求 Flutter 3.44+ 和 Dart 3.12+，限制了与旧项目的兼容性

README 快速开始

VModal for Flutter Give your Android and iOS apps a multimodal memory. Upload video. Find moments by meaning, speech, text, or imagery.Keep the experience fast, native, and 100% Flutter.

Turn every video library into an experience your users can explore.

Build the feature people remember

VModal brings multimodal video search and mobile-friendly uploads to Dart with a small, typed API. Your app owns the interface; the SDK handles the VModal gateway, request models, responses, upload streams, progress, and cancellation.

Your Flutter experience	VModal gives you
“Find the cyclist in the red jacket”	Semantic video and image search
Search words spoken or shown on screen	ASR and OCR search sources
Upload from a picker or camera flow	Streamed, signed uploads with live progress
A cancel button that really cancels	Per-operation cancellation tokens
Collection and indexing screens	Typed collection, index, usage, and image resources
Login and account switching your way	App-owned runtime credentials—no login UI imposed

Gettting started with one prompt

Copy this prompt into your coding agent:

1. Clone https://github.com/v-modal/vmodal_sdk_flutter.git and enter the
   vmodal_sdk_flutter directory.
2. Inspect the repository instructions and
   example/01_full_app/README.md before making changes.
3. Use the repository's pinned Flutter toolchain; do not install another
   global Flutter version. Run:
     bash install.sh install
     bash build.sh pub_get
     bash build.sh analyze
     bash build.sh test
4. Start or select an Android emulator/device or, on macOS, an iOS
   simulator/device. List devices with:
     flutter_bin="$(bash install.sh flutter_bin)"
     "$flutter_bin" devices
5. Run example/01_full_app on the selected mobile device with:
     bash run.sh example --device DEVICE_ID

Keep working until the app builds, installs, and opens. Fix any repository
setup issue you can safely resolve. Do not add Flutter Web support, hard-code
credentials, or persist an API key. When the app opens, explain how to enter a
runtime VModal API key and complete the authentication, collection, upload,
index, and search flow. If a required host tool, emulator, simulator, or API
key is unavailable, stop at that boundary and report the exact blocker and the
next command I should run.
`

项目描述

V- Modal AI: Search anything anywhere SDK Flutter

vmodal_sdk_flutter