How cogwheel0/conduit works
Conduit is a native Flutter mobile client for Open WebUI, compatible model endpoints, and self-hosted Hermes agents. Users connect an endpoint, authenticate when needed, then chat with streaming responses, attachments, and voice; they can also use workspace tools and other server-enabled features. Flutter feature modules implement the product, while Android and iOS bridges provide platform services such as background streaming, speech, widgets, and sharing. The README documents the main capabilities and integrations; several feature implementations were not sampled, so their internal call paths are not asserted.
Main entry points: chat_page.dart Chat interface · chat_transport_dispatch.dart Chat transport · providers Chat orchestration · views Connection setup
Components 25
Connection and Auth
- Connection setup
lib/features/auth/views - Authentication
lib/features/auth/views - Open WebUI
- Direct providers
packages/conduit_core/lib/features/direct_connections - Hermes agent
lib/features/hermes
Chat and Voice
- Chat interface
lib/features/chat/views/chat_page.dart - Chat orchestration
lib/features/chat/providers - Chat transport
lib/features/chat/services/chat_transport_dispatch.dart - Message rendering
packages/conduit_markdown/lib - Media attachments
lib/features/chat/services - Voice services
lib/features/chat/services/voice_input_service.dart
Product Features
Native Platform
- Background streaming
android/app/src/main/kotlin/app/cogwheel/conduit/BackgroundStreamingHandler.kt - Android app bridge
android/app/src/main/kotlin/app/cogwheel/conduit/MainActivity.kt - iOS app bridge
ios/Runner/AppDelegate.swift - Native speech
ios/Runner/NativeSttBridge.swift - Share extension
ios/ShareExtension/ShareViewController.swift - Share envelope store
ios/ShareExtension/NativeShareEnvelopeStore.swift - iOS widget
ios/ConduitWidget/ConduitWidget.swift
App Foundation
- Local persistence
packages/conduit_core/lib/database - App navigation
lib/core/router/app_router.dart
Other components
- Mobile user
Connections 22
- Mobile user → Connection setup: chooses connection
README.md - Connection setup → Authentication: starts sign-in
README.md - Authentication → Open WebUI: authenticates with
README.md - Mobile user → Chat interface: starts conversation
README.md - Chat interface → Chat orchestration: submits prompt
README.md - Chat orchestration → Chat transport: dispatches request
- Chat transport → Open WebUI: sends requests
README.md - Chat transport → Direct providers: sends requests
README.md - Chat transport → Hermes agent: connects agent
README.md - Chat interface → Message rendering: shows replies
README.md - Chat interface → Media attachments: accepts media
README.md - Chat interface → Voice services: offers voice
README.md - Chat interface → Workspace: opens workspace
README.md - Chat interface → Channels: opens channels
README.md - Chat interface → Notes: opens notes
README.md - Chat interface → Terminal: opens terminal
README.md - Chat orchestration → Local persistence: persists chats
README.md - Mobile user → App navigation: navigates app
- Android app bridge → Background streaming: configures streaming
android/app/src/main/kotlin/app/cogwheel/conduit/MainActivity.kt - iOS app bridge → Native speech: configures speech
ios/Runner/AppDelegate.swift - Share extension → Share envelope store: publishes envelope
ios/ShareExtension/ShareViewController.swift - iOS widget → iOS app bridge: opens app links
README.md