Skip to content

Latest commit

 

History

25 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

IronPrompt

Framework UI Library Native AOT License

IronPrompt is a sleek, state-of-the-art desktop client for interacting with local Ollama LLMs. Designed with modern aesthetics and premium glassmorphism in mind, it provides a fast, tactile, and highly responsive user experience.

It is fully optimized for .NET 10 and built from the ground up to support 100% Native AOT (Ahead-of-Time) compilation, achieving near-instantaneous startup times and minimum memory footprints.


Key Features

  • Premium Glassmorphism UI: Harmony-driven dark mode color palette (#101018 base) styled with smooth gradient buttons, semi-transparent panels, and subtle micro-animations.
  • Integrated Model Manager: A premium tabbed overlay modal for managing Ollama models:
    • Installed Models: View all locally installed models with formatted sizes in GB, select active session models, or securely delete models with warning confirmations.
    • Download Models: Input and pull custom tags from Ollama Library (with real-time progress stream, validation tips, and robust localized error interception).
  • Hot-Swappable Localization (TR / EN): Dynamic Turkish and English support. All static texts, placeholders, and error messages translate instantly without application restarts.
  • Image Attachment & Vision Support: Add images to your chat sessions via drag-and-drop, clipboard pasting (Ctrl+V), or open file picker. Uses connection-aware lazy capability checking to verify model compatibility.
  • Modern Settings Modal: An overlay modal for configuring application language and toggling the auto-scroll behavior (to control whether the chat automatically scrolls down as responses stream in).
  • Intelligent Connection Monitoring: A background connection loop that detects when Ollama is offline, locks the UI with a red warning banner, and seamlessly updates capabilities once connection is restored.
  • Advanced Markdown & Tables: Renders headers, lists, bold/italic, inline code blocks, and interactive markdown tables natively with auto-scaling columns.
  • Smart Code Blocks: Syntax highlighting wrapper featuring a one-click copy button and horizontal scrolling.
  • Thinking Process Visualization: Specialized styling and visual steps representing deep-thinking states (e.g. <think> blocks in reasoning models) with active/completed states.
  • Session & Boundaries Persistence: Remembers window dimensions, position, maximized/minimized state, scroll offsets, active model choice, and session history.

Technical Architecture

  • Framework: .NET 10 & Avalonia UI (MVVM)
  • Code Generation: Utilizes source generators (CommunityToolkit.Mvvm) for reactive bindings.
  • JSON Serialization: Configured using compile-time source-generated JSON reflection contexts (System.Text.Json.Serialization.JsonSerializerContext) to ensure full Native AOT compatibility.

Getting Started

Prerequisites (For Everyone)

  • Ollama: Ensure Ollama is installed and running locally on your machine:
    ollama run gemma4:e4b # Or any model of your choice (e.g. gemma4:26b)

Option 1: Quick Start (For General Users)

Because IronPrompt is compiled as a Native AOT self-contained application, it runs 100% independently on Windows. You do not need to install .NET 10 SDK, .NET Runtimes, or any other external frameworks!

  1. Go to the Releases page.
  2. Select your preferred distribution format:
    • Standard Installer (IronPromptSetup.exe): A professional installer wizard that automatically installs the program, registers shortcuts, and creates a Start Menu entry for easy access.
    • Portable Archive (IronPrompt-win-x64.zip): A standalone, lightweight package. Simply extract the ZIP file anywhere on your system and run IronPrompt.exe immediately without installation.

Option 2: Build & Run from Source (For Developers)

If you want to compile the project yourself or contribute to the codebase:

  1. Install .NET 10 SDK: Download .NET 10 SDK
  2. Clone the repository:
    git clone https://github.com/arda-ceylan/IronPrompt.git
    cd IronPrompt
  3. Run the application using the dotnet CLI:
    dotnet run --project IronPrompt/IronPrompt.csproj

Native AOT Compilation

To publish the application as a single-file, self-contained native executable with maximum optimization and no external dependencies:

dotnet publish IronPrompt/IronPrompt.csproj -c Release -r win-x64 --self-contained true

The resulting executable will be generated under bin\Release\net10.0\publish\win-x64\.


Screenshots


Main Chat Interface
Figure 1: Main chat view featuring the custom TR/EN segmented switch and dark glassmorphism.
Deep Thinking and Code Blocks
Figure 2: Interactive deep thinking reasoning step visualization and syntax-highlighted code blocks.
English UI Localization
Figure 3: Complete, seamless dynamic English UI translation in action across all controls.
Session Control Context Menu
Figure 4: Tactile chat session control with dynamic inline rename and right-click delete options.


License

Copyright © 2026 Arda Ceylan.

Licensed under the Apache License, Version 2.0. LICENSE

About

A blazing fast, native desktop chat interface for Ollama (Gemma), built with Avalonia UI and fully optimized for Native AOT execution.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages