conduit  by cogwheel0

Native mobile client for self-hosted AI chat

Created 7 months ago
1,251 stars

Top 31.3% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

Conduit is a native mobile client for OpenWebUI, designed to enhance the self-hosted AI chat experience on iOS and Android. It addresses common mobile limitations such as authentication, streaming stability, and content sharing, providing a polished and performant interface for daily use. The project targets users of self-hosted OpenWebUI instances, offering a seamless bridge between desktop power and mobile convenience.

How It Works

Conduit is built using Flutter and leverages Riverpod 3 for state management and GoRouter for navigation. It employs WebSocket-backed streaming for real-time, token-by-token responses, ensuring reliable long-running chats. The application features native rendering of complex AI outputs, including syntax-highlighted code, LaTeX, Mermaid diagrams, and Chart.js embeds, providing a rich and interactive user experience directly on mobile devices.

Quick Start & Requirements

Users can install Conduit directly from the App Store or Google Play. For building from source, requirements include a recent Flutter SDK with Dart 3.8+, Java 17 for Android builds, Android 7.0+ or iOS 16.0+, and Xcode or Android Studio. The build process involves cloning the repository, running flutter pub get, executing dart run build_runner build --delete-conflicting-outputs, and then flutter run.

Highlighted Details

  • Comprehensive AI Workflow Support: Handles file and image uploads, multimodal prompts, server-side tools, saved prompts with variables, and optional web search or image generation.
  • Robust Authentication: Supports username/password, LDAP, JWT, custom headers, SSO/OAuth, and reverse proxy login flows, storing credentials securely in platform keystores.
  • Rich Content Rendering: Natively renders syntax-highlighted code blocks, LaTeX, Mermaid, Chart.js, citations, reasoning blocks, and tool-call details.
  • Deep Mobile Integration: Features home screen widgets, app quick actions, iOS App Intents/Shortcuts, and share-sheet ingestion for seamless content input.

Maintenance & Community

Conduit is actively developed, with feedback encouraged via GitHub Issues for bugs and GitHub Discussions for features and questions. While unsolicited pull requests are not the primary contribution path, community engagement is welcomed through these channels. Development can be supported via GitHub Sponsors or Buy Me a Coffee.

Licensing & Compatibility

The project is released under the GPL-3.0 License. This strong copyleft license requires derivative works to also be open-sourced under the same terms, which may have implications for commercial use or integration with closed-source software. Conduit is an independent client and is not affiliated with OpenWebUI.

Limitations & Caveats

Streaming reliability depends on the Open WebUI deployment having WebSocket support enabled (ENABLE_WEBSOCKET_SUPPORT="true"). Specific build failures may require platform-specific troubleshooting steps, such as running pod install for iOS or flutter clean for Android. Code generation issues can be resolved by rerunning the build runner command.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
14
Issues (30d)
20
Star History
161 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.