Skip to content

Project overview, planning, implementation and roadmap of Hazle, an AI assistant fully developed in Kotlin

License

Notifications You must be signed in to change notification settings

tashilapathum/hazle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

Hazle

Get AI summaries for anything on-the-go while you're browsing.

The project is under development and the code can be found in hazle-android and hazle-backend repos.

Project Architecture

deepseek_mermaid_20250530_7533cb

Tech Stack

  1. Android Client:

    • Jetpack Compose: Material 3 dynamic UI with dark/light theme
    • Koin: Dependency injection for clean architecture
    • Ktor: API handling from client-side
    • Coroutines: Background message processing
    • Room: Local caching for offline support
  2. Ktor Backend (Middleware):

    • Auth API: JWT token handling
    • Chat API: Message queue management
    • OpenAI API: AI integration for message responses
    • Koin: Dependency injection
  3. Supabase Services:

    • Auth: Email/password + social logins
    • Realtime DB: PostgreSQL for chat history (roadmap)
    • Storage: File attachments (roadmap)

MVP Features

Component Functionality
Auth Flow App → Ktor → Supabase Auth → JWT token → Session management
Chat Process User message → Ktor → OpenAI → Ktor → Push notification
Notification Tap opens chat thread with context-aware history
Offline Local caching with message queue for retries

Phase Roadmap

  1. MVP (Current): [Progress tracker]

    • Auth + basic chat
    • Notification system
    • Compose UI with themes
    • English, Sinhala and German languages
    • Marketing and pricing
      • a. Sri Lankan audience
        • Subscription pricing model with IdeaMart
        • Focused on translation more
      • b. International audience
        • Subscription pricing model with Google Play billing
        • Focused on summarizing articles
  2. V2 (Quality of life features): [Progress tracker]

    • Supabase realtime chat sync
    • Prompt engineering dashboard
    • Message history
    • File attachment support
    • More localization
  3. V3 (Cross-platform): [Progress tracker]

    • Shared KMP core module
    • iOS UI with Compose Multiplatform
    • Configurable AI personalities
    • Usage analytics

Learning Opportunities

Technology Key Concepts Learned
Jetpack Compose Material 3 Expressive theming, custom animations
Koin Cleaner modular code with Dependency injection
Ktor REST API development, middleware
Supabase Firebase alternative, Authentication, PostgreSQL management
Localization Multi-language support with Componse UI, German language

About

Project overview, planning, implementation and roadmap of Hazle, an AI assistant fully developed in Kotlin

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published