Conduit is a Flutter-based AI chat application for Android. Connect to multiple AI providers — OpenAI, Anthropic, Gemini, Ollama, and more — from a single interface.

Prerequisites

• Flutter SDK 3.22 or later
• Dart SDK 3.12 or later (included with Flutter)
• Android Studio or VS Code with Flutter extension

Quick Start

git clone https://github.com/Harsha754-ml/Conduit.git
cd conduit
flutter pub get
flutter run

First Launch

1. Launch the app on your device or emulator
2. Navigate to Settings → Providers
3. Select a provider (OpenCode is built-in, no key needed)
4. For cloud providers, enter your API key
5. Start chatting

Conduit supports 11 providers through a unified interface. API keys are encrypted and stored locally — never sent anywhere except the provider you configure.

Fine-tune the AI behavior with model parameters, system prompts, and advanced settings.

Model Parameters

System Prompts

System prompts define the AI's behavior and personality. Create, save, and reuse prompts from Settings → Prompts.

You are a helpful coding assistant.
Always provide working code examples.
Explain your reasoning step by step.

Base URL Override

For self-hosted or proxied providers, override the default API endpoint in Settings → Providers → Advanced. Useful for Ollama on a different machine, VPN configurations, or API proxies.

Build release artifacts for Android or run in debug mode for development.

Android

flutter build apk --debug

flutter build apk --release

flutter build appbundle --release

Split APKs

flutter build apk --release --split-per-abi

# Outputs:
# app-armeabi-v7a-release.apk
# app-arm64-v8a-release.apk
# app-x86_64-release.apk

Signing (Release)

Create a keystore and configure Gradle signing for Play Store distribution.

keytool -genkey -v \
  -keystore conduit-release-key.jks \
  -keyalg RSA -keysize 2048 \
  -validity 10000 -alias conduit

Conduit follows Clean Architecture with a feature-based folder structure, Riverpod for state management, and GoRouter for navigation.

lib/
├── core/           Shared infrastructure
│   ├── config/     App configuration
│   ├── network/    Dio, SSE, WebSocket clients
│   ├── providers/  Riverpod overrides
│   ├── router/     GoRouter navigation
│   ├── storage/    Hive & Secure Storage
│   ├── theme/      Material 3 themes
│   └── utils/      Extensions and helpers
├── features/       Feature modules
│   ├── chat/       Core chat functionality
│   ├── settings/   App & provider settings
│   ├── history/    Conversation history
│   ├── prompts/    System prompt management
│   ├── export/     PDF & text export
│   ├── voice/      Speech-to-text & TTS
│   └── attachments/ File & image handling
├── providers/      AI provider abstraction
├── shared/         Shared widgets
├── app.dart
└── main.dart

Layer Architecture

Provider Abstraction

Every AI provider implements the standard interface. The ProviderRegistry routes requests to the active provider.

interface AIProvider {
  sendMessage(...) → String
  streamMessage(...) → Stream
  listModels(...) → List<ModelInfo>
  healthCheck(...) → HealthCheckResult
}

Conduit stores all data locally. No analytics, no telemetry, no tracking. Your data stays on your device.

Data Flow

Platform Security