Vision Bridge

A Visionary Art Interpretation LLM App for the Blind.

For a more detailed development process and API design, please refer to MangoJump.

Overview

Vision Bridge is a Flutter application designed to provide visually impaired users with an innovative way to interpret and experience art through AI-powered tools. The app leverages machine learning models and Flutter's cross-platform capabilities to deliver a seamless user experience.

Features

• AI-Powered Art Interpretation: Uses advanced machine learning models to describe and interpret art.
• Cross-Platform Support: Runs on Android, iOS, Windows, macOS, Linux, and Web.
• Accessibility First: Designed with accessibility in mind, including screen reader support.

Getting Started

Please make sure your phone has NFC functionality.

Prerequisites

• Flutter SDK (version 3.0.0 or higher)
• Dart 2.17.0 or higher
• Android Studio or Visual Studio Code (recommended for development)

Installation

1. Clone the repository:

   git clone https://github.com/IdONTKnowCHEK/Vision-Bridge
   cd vision-bridge

2. Install dependencies:

   flutter pub get

3. Run the app:

   flutter run

Android Installation (End User)

1. Navigate to the Releases page on GitHub.
2. Download the latest app-release.apk file.
3. On your Android device, enable installation from unknown sources:
   • Go to Settings > Security (or Apps & notifications > Special app access).
   • Enable Install unknown apps for your browser or file manager.
4. Open the downloaded APK and follow the prompts to install Vision Bridge.

iOS Installation (End User)

Note: iOS installation requires code signing or TestFlight distribution and cannot be installed directly via an APK-like file.

Option 1: TestFlight (Recommended for testers)

1. The app owner must upload a build to App Store Connect and invite you as a tester.
2. Install the TestFlight app from the App Store.
3. Accept the invitation email or public link.
4. Open TestFlight and tap Install next to Vision Bridge.

Option 2: Build & Deploy via Xcode

1. Ensure you have a valid Apple Developer account and provisioning profile.
2. Connect your iPhone to your Mac via USB.
3. Open the project in Xcode:

   open ios/Runner.xcworkspace

4. In Xcode, select your Development Team under Signing & Capabilities for the Runner target.
5. Choose your device as the build target and click Run (▶️) to install.

Directory Structure

lib/
├── main.dart         # Entry point of the application
├── screens/          # UI screens
├── components/       # Reusable widgets
├── models/           # Data models
├── services/         # Business logic and API integrations
├── utils/            # Utility functions and constants

Configuration

Assets

Add your assets (e.g., images, audio files) to the assets/ directory and register them in pubspec.yaml:

flutter:
  assets:
    - assets/images/
    - assets/audios/

Dependencies

The project uses the following Flutter packages:

• provider: State management
• http: API requests
• path_provider: File system paths
• permission_handler: Permission management
• nfc_manager: NFC functionality

For a full list of dependencies, see the pubspec.yaml file.