StudyOS Agent

This is an agent for the University of Tuebingen.

Flutter migration

The repository now contains a Flutter migration shell in flutter_app/. The existing native Android Java project remains in place while the Flutter app becomes the new cross-platform UI experiment.

Current migration shape:

• Flutter owns the main chat UI, input bar, status display, and capability drawer.
• Android native code is copied into the Flutter Android runner and exposed through MethodChannel/EventChannel bridge hooks.
• Android keeps OS-level integrations such as services, reminders, sensors, app launching, speech/TTS, and LiteRT/LiteRTLM.
• iOS registers the same native bridge and exposes iOS-safe native APIs for location-backed world state, local notification reminders, speech availability, text-to-speech, and Apple Foundation Models when the SDK/device supports the Foundation Models framework.
• Web and desktop currently run the Flutter UI shell only; unsupported native bridge calls return explicit errors instead of mock data.

Run the migration shell with:

cd flutter_app
flutter run

The first migration PR is intentionally a bridge-first implementation. It does not rewrite every Android service in Dart because many current features are Android-specific and should stay behind native adapters.

Installing builds

Installable app bundles are built by the Build and Release Artifacts GitHub Actions workflow for Android, web, Linux, macOS, and Windows. iOS is skipped because distribution needs to go through Apple's signing and App Store/TestFlight flow.

• For branch and pull request builds, open the workflow run and download the platform artifact you need, such as studyos-agent-android-apk, studyos-agent-web, studyos-agent-linux-x64, studyos-agent-macos, or studyos-agent-windows-x64.
• For tagged releases such as v1.0.0, or a flutter_app/pubspec.yaml version change on main, download the platform artifact from the matching GitHub Release.

Android may ask you to allow installing APKs from your browser or file manager before opening the downloaded build. The APK is currently signed with the debug signing configuration from the Flutter Android runner, so it is suitable for course testing but not yet for app-store distribution.