Blurr Android Voice Assistant Development

Development guidelines for building and maintaining Blurr, an Android application that functions as an AI assistant with voice control capabilities.

Project Overview

Blurr is an Android AI assistant that allows users to interact with their devices using natural language voice commands. It leverages Google Gemini API for natural language processing and Puter.js for cloud services.

Technology Stack

**Core Technologies:**

Development Environment Setup

Required Tools

API Configuration

Create `local.properties` in project root:

```properties

sdk.dir=/path/to/your/android/sdk

GEMINI_API_KEYS=your_comma_separated_gemini_keys

TAVILY_API=your_tavily_api_key

MEM0_API=your_mem0_api_key

```

**API Service URLs:**

Code Structure

```

app/src/main/java/com/blurr/voice/

├── agents/ # AI agents for specific tasks

├── api/ # API clients (Gemini, Tavily, Mem0)

├── data/ # Models and repositories

├── ui/ # Activities and Compose components

├── utilities/ # Helper classes

├── services/ # Background services

└── managers/ # Feature managers (Puter, TTS, etc.)

```

**Key Files:**

Architecture Guidelines

Patterns

1. **MVVM**: Separate UI, business logic, and data layers

2. **Repository Pattern**: Abstract data sources behind repositories

3. **Manual Dependency Injection**: Constructor injection for testability

4. **Coroutines**: Use for all async operations and threading

Key Components

Build Commands

```bash

Build debug APK

./gradlew assembleDebug

Build release APK

./gradlew assembleRelease

Install debug APK to device/emulator

./gradlew installDebug

Run unit tests

./gradlew test

Run instrumented tests

./gradlew connectedAndroidTest

```

Testing Guidelines

**Test Locations:**

**Frameworks:**

**Example test pattern:**

```kotlin

@Test

fun testFeature() = runBlocking {

// Arrange

val testData = createTestData()

// Act

val result = featureUnderTest.execute(testData)

// Assert

assertEquals(expected, result)

}

```

Debugging

Logcat Monitoring

```bash

Monitor Gemini API logs

adb logcat | grep GeminiApi

Monitor all app logs

adb logcat | grep "com.blurr.voice"

Clear logcat and start fresh

adb logcat -c && adb logcat

```

Common Debug Tags

Important Notes

Critical Constraints

Resource Locations

Permissions Required

Development Workflow

1. **Feature Development**: Create feature branch from `main`

2. **Code Changes**: Follow MVVM pattern, write tests

3. **Local Testing**: Run unit and instrumentation tests

4. **Manual Testing**: Install on device/emulator

5. **Code Review**: Submit PR with test coverage

6. **Merge**: Squash and merge to `main`

Best Practices