Kollama

Kollama is a modern, desktop chat interface for Ollama models built with Kotlin and Jetpack Compose for Desktop. It provides a sleek, user-friendly way to interact with local AI models while offering advanced features like code formatting, markdown support, and animated UI elements.

Features

• 🚀 Modern Desktop UI: Built with Compose for Desktop for a native, responsive experience
• 💬 Real-time Chat Interface: Smooth, chat-like interaction with AI models
• 🎨 Rich Markdown Support: Full markdown rendering including:
  • Syntax-highlighted code blocks
  • Tables
  • Lists and task lists
  • Blockquotes
  • Headers and formatting
• 🔄 Advanced Message Handling:
  • Real-time message streaming
  • Message retry functionality
  • Copy to clipboard support
  • Message status indicators
• 💾 Persistent Storage: Local SQLite database for chat history using Room
• 🎯 Multiple Model Support: Switch between different Ollama models seamlessly
• 🎭 Dark/Light Theme: Automatic theme switching with animated transitions
• ✨ Polished UI Elements:
  • Animated message borders
  • Pulsating status indicators
  • Smooth transitions and animations
  • Responsive layout

Screenshots

Mack Installer

https://drive.google.com/file/d/11_hz3-sKSTjTnqQ3wgwt7qI8EBqSQcwV/view?usp=sharing

Prerequisites

• JDK 17 or higher
• Ollama installed and running on your machine, app uses tcp to communicate with Ollama
• At least one Ollama model downloaded

Getting Started

1. Install Ollama following the instructions at Ollama's official website
2. Pull at least one model using Ollama CLI:

   ollama run deepseek-r1:1.5b

3. Clone this repository:

   git clone https://github.com/kashif-e/kollama.git

4. Build and run using Gradle:

   ./gradlew run

Architecture

Kollama follows clean architecture principles and is organized into the following layers:

• Presentation: Compose UI components and ViewModels
• Domain: Business logic and model definitions
• Data: Repository implementations and local database
• DI: Dependency injection using Koin

Key Components

• ChatViewModel: Manages chat state and user interactions
• OllamaService: Handles communication with Ollama models
• ChatDatabase: Local storage using Room
• MarkdownFormatting: Custom markdown processing and formatting

Technical Features

Database

• Room database for persistent storage
• Entities for chat sessions and messages
• Foreign key relationships for data integrity

UI Components

• Custom composables for chat bubbles, model selection, and more
• Animated modifiers for enhanced visual feedback
• Markdown rendering with customizable typography

State Management

• Kotlin Flow for reactive state updates
• ViewModel for UI state management
• Coroutines for asynchronous operations

Development

Project Structure

kollama/
├── data/
│   ├── local/
│   │   ├── dao/
│   │   └── database/
│   └── repository/
├── domain/
│   ├── model/
│   └── repository/
├── presentation/
│   ├── components/
│   ├── modifier/
│   ├── state/
│   └── theme/
└── di/

Building

# Build the project
./gradlew build

# Run the application
./gradlew run

# Create distribution
./gradlew createDistribution

Customization

Model Configuration

Configure Ollama model settings in OllamaService.kt:

fun setGpuLayers(layers: Int)
fun setCudaDevices(devices: String)
fun setMaxRamUsage(ramMb: Int)
fun setMaxGpuMemory(memoryMb: Int)

UI Customization

• Modify themes in theme package
• Customize markdown styles in rememberMarkdownTypography
• Adjust animations in AnimatedModifier.kt

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

Acknowledgments

• Jetpack Compose for Desktop
• Ollama
• Room
• Koin