https://github.com/lsxprime/proseflow
ProseFlow: Your universal AI text processor, powered by local and cloud LLMs. Edit, refactor, and transform text in any application on Windows, macOS, and Linux.
https://github.com/lsxprime/proseflow
ai avalonia cross-platform csharp desktop-app developer-tools dotnet gguf linux llm macos productivity windows writing-tool
Last synced: 12 days ago
JSON representation
ProseFlow: Your universal AI text processor, powered by local and cloud LLMs. Edit, refactor, and transform text in any application on Windows, macOS, and Linux.
- Host: GitHub
- URL: https://github.com/lsxprime/proseflow
- Owner: LSXPrime
- License: agpl-3.0
- Created: 2025-09-23T15:19:52.000Z (19 days ago)
- Default Branch: master
- Last Pushed: 2025-09-23T15:34:21.000Z (19 days ago)
- Last Synced: 2025-09-23T17:36:51.462Z (19 days ago)
- Topics: ai, avalonia, cross-platform, csharp, desktop-app, developer-tools, dotnet, gguf, linux, llm, macos, productivity, windows, writing-tool
- Language: C#
- Homepage: https://lsxprime.github.io/proseflow-web/
- Size: 43 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: Changelogs/v0.1.0.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# ProseFlow
**Your Universal AI Text Processor, Powered by Local and Cloud LLMs.**
**[Official Website](https://lsxprime.github.io/proseflow-web)**
[](https://github.com/LSXPrime/ProseFlow/actions/workflows/release.yml) [](https://www.gnu.org/licenses/agpl-3.0) [](https://dotnet.microsoft.com/download/dotnet/8.0) [](https://github.com/LSXPrime/ProseFlow/releases) [](https://huggingface.co/datasets/LSXPrime/ProseFlow-Actions-v1)
ProseFlow is a cross-platform desktop application that integrates powerful AI text processing into your daily workflow.
With a simple hotkey, you can access a menu of customizable AI actions to proofread, summarize, refactor, or transform
text in *any* application—be it your code editor, browser, or word processor.
Its unique hybrid engine allows you to seamlessly switch between the world's best cloud-based LLMs and private, offline-capable models running directly on your own hardware.
---
[](https://thebsd.github.io/StandWithPalestine)
This project stands in solidarity with the people of Palestine and condemns the ongoing violence and ethnic cleansing by Israel. We believe developers have a responsibility to be aware of such injustices.
---
### Screenshots
Floating Action Menu
Comprehensive Dashboard
Action Management
Local Model Library
---
Table of Contents
- [Features](#-features)
- [Getting Started](#-getting-started)
- [How to Use](#-how-to-use)
- [Official Local Models](#-official-local-models)
- [Architecture Overview](#-architecture-overview)
- [Support This Project](#-support-this-project)
- [Building from Source](#-building-from-source)
- [Technology Stack](#-technology-stack)
- [Contributing](#-contributing)
- [License](#-license)
- [Acknowledgements](#-acknowledgements)
---
### ✨ Features
ProseFlow is packed with features designed for power, privacy, and productivity.
#### 🚀 Core Workflow
* **Global Hotkey Activation:** Access ProseFlow from **any application** with a customizable system-wide hotkey.
* **Floating Action Menu:** An elegant, **searchable menu** of your AI actions appears right where you need it.
* **Smart Paste:** Assign a dedicated hotkey to your most frequent action for **one-press text transformation**.
* **Flexible Output:** Choose to have results **instantly replace** your text or open in an **interactive window** for review.
* **Iterative Refinement:** **Conversationally refine** AI output in the result window until it's perfect.
* **Context-Aware Actions:** Configure actions to only appear when you're in **specific applications**.
#### 🧠 Hybrid AI Engine
* **Run 100% Locally & Offline:** Use **GGUF-compatible models** on your own hardware for maximum **privacy** and offline access.
* **Official Fine-Tuned Models:** Download our **custom-built models**, which are specifically **optimized for ProseFlow's tasks** to provide the best possible local experience. [Learn More](#-official-local-models)
* **Connect to Cloud APIs:** Integrates with **OpenAI, Groq, Anthropic, Google**, and any **OpenAI-compatible endpoint**.
* **Intelligent Fallback Chain:** Configure multiple cloud providers. If one fails, ProseFlow **automatically tries the next**.
* **Secure Credential Storage:** API keys are **always encrypted** and stored securely on your local machine.
#### 🛠️ Customization & Management
* **Custom AI Actions:** Create **reusable AI instructions** with unique names, icons, and system prompts.
* **Action Groups:** Organize your actions into logical groups with a **drag-and-drop interface**.
* **Import & Export:** **Share your action sets** with others or back up your configuration to a JSON file.
* **Action Presets:** Get started quickly by importing **curated sets of actions** for common tasks like writing, coding, and more.
#### 📊 Dashboard & Analytics
* **Usage Dashboard:** Visualize your **token usage over time** for both cloud and local models.
* **Performance Monitoring:** Track **provider latency** and **tokens/second** to optimize your setup.
* **Live Hardware Monitor:** See real-time **CPU, GPU, RAM, and VRAM usage** when running local models.
* **Interaction History:** Review a **detailed log** of all your past AI operations.
#### 💻 Platform Integration
* **Cross-Platform:** Native support for **Windows, macOS, and Linux**.
* **System Tray Control:** Runs quietly in the background with a **tray icon for quick access** to key functions.
* **Launch at Login:** Configure ProseFlow to **start automatically** with your system.
* **Guided Onboarding:** A **smooth setup process** for new users to get configured in minutes.
---
### 🚀 Getting Started
The easiest way to get started is by downloading the latest version from our official website.
### **[➡️ Download from the Official Website ⬅️](https://lsxprime.github.io/proseflow-web)**
The website will automatically suggest the best download for your operating system (Windows, macOS, or Linux).
1. **Download the Installer:** Click the main download button on the website for your detected OS, or choose a specific
version from the options below it.
2. **Install & Run:** Install the application like any other.
3. **Onboarding:** The first time you run ProseFlow, a guided setup window will help you configure your first AI
provider and set your global hotkey. You'll be ready in minutes!
For advanced users who need access to all builds, portable versions, or detailed release notes, you can visit
the [GitHub Releases page](https://github.com/LSXPrime/ProseFlow/releases).
---
### 📖 How to Use
The core workflow is designed to be fast and intuitive:
1. **Select Text:** Highlight any text in any application.
2. **Press Hotkey:** Press your configured Action Menu hotkey (default is `Ctrl+J`).
3. **Choose an Action:** The floating menu will appear. Use your mouse or arrow keys to select an action and press
`Enter`.
4. **Get Results:**
* For quick edits (like "Proofread"), your selected text will be replaced instantly.
* For longer content (like "Explain Code"), a result window will appear with the generated text.
---
### 🧠 Official Local Models
To provide the best possible out-of-the-box experience, we have fine-tuned and released official models specifically for ProseFlow. These models are optimized to understand the application's unique instruction format and excel at a wide range of tasks.
Both models are available for one-click download directly within ProseFlow from the Model Library (`Providers -> Manage Models...`).
| Model | Best For | VRAM (Approx.) |
| :--- | :--- | :--- |
| **[ProseFlow-v1-1.5B-Instruct](https://huggingface.co/LSXPrime/ProseFlow-v1-1.5B-Instruct) (Recommended)** | The **best overall experience**. A versatile model based on `Qwen2.5-Coder` that excels at coding, logical reasoning, and high-quality text generation. The `Q8_0` quant is recommended. | ~2.5 GB |
| **[ProseFlow-v1-360M-Instruct](https://huggingface.co/LSXPrime/ProseFlow-v1-360M-Instruct) (Experimental)** | **Extremely lightweight** use on low-resource devices. Fast, but with significant limitations in reasoning and complex tasks. Suitable for basic text formatting. | ~1 GB |
For most users, the **`1.5B-Instruct`** model provides an ideal balance of high performance and manageable resource requirements.
The task-focused ability of our official models is made possible by the custom dataset they were trained on, which we have also open-sourced for the community, **[ProseFlow-Actions-v1](https://huggingface.co/datasets/LSXPrime/ProseFlow-Actions-v1)** is a high-quality, diverse dataset of over 1,800 structured examples. Unlike general-purpose chat datasets, it's specifically designed for the "tool-based" workflow of ProseFlow, focusing on tasks that require high-fidelity text transformation and strict adherence to formatting constraints.
By open-sourcing the data, we invite developers and researchers to inspect our methodology, build upon our work, and create even better small, task-focused models. The dataset is released under the permissive **MIT License**.
---
### 🏗️ Architecture Overview
ProseFlow is built using a modern, layered architecture inspired by **Clean Architecture**, promoting separation of
concerns, testability, and maintainability.
* **`ProseFlow.Core`**: The domain layer. Contains the core business models, enums, and interfaces for repositories and
services. It has zero dependencies on other layers.
* **`ProseFlow.Application`**: The application layer. It orchestrates the business logic using services, DTOs, and
application-specific events. It depends only on `Core`.
* **`ProseFlow.Infrastructure`**: The infrastructure layer. Contains all implementations of external concerns,
including:
* **Data Access:** Entity Framework Core with SQLite using the Repository & Unit of Work patterns.
* **AI Providers:** Implementations for Cloud (`LlmTornado`) and Local (`LLamaSharp`) providers.
* **OS Services:** Cross-platform hotkeys (`SharpHook`), clipboard access, and active window tracking.
* **`ProseFlow.UI`**: The presentation layer. A cross-platform desktop application built with **Avalonia** and the **ShadUI** component library, following the **MVVM** pattern.
---
## ❤️ Support This Project
ProseFlow is an open-source project driven by a single developer on a single PC. The goal is to create a powerful, private, and flexible AI writing assistant that works flawlessly for everyone, regardless of their operating system.
However, developing and maintaining a professional cross-platform application comes with significant challenges and costs that are difficult to cover alone.
**The Current Reality:**
ProseFlow is actively developed and tested on **Windows and Linux (via WSL)**. Due to a lack of hardware, **I am currently unable to properly test, debug, build, or release for macOS.** The current macOS support is "best-effort" and relies on community feedback, which is not a sustainable way to ensure a quality product.
### Your Support Directly Enables:
* **First-Class macOS Support:** The single biggest hurdle for the project. Your contributions will go directly towards acquiring a Mac for dedicated macOS development. This is essential for:
* Properly testing and debugging the application.
* Building official, signed, and notarized releases.
* Fixing platform-specific bugs and ensuring a native feel.
* **Official Code Signing & Notarization:** To keep the application safe and functional, we need:
* **An Apple Developer Account ($99/year):** Required for building and distributing a trusted macOS application.
* **A Windows Code Signing Certificate:** Essential for removing the "untrusted application" warnings on Windows, making ProseFlow a secure and trustworthy tool you can rely on.
* **Dedicated Development Time:** Your support allows me to dedicate more focused time to development, leading to faster feature implementation, more thorough bug fixes, and better overall project quality across all platforms.
You can directly support ProseFlow and help transform it into a truly professional, cross-platform tool through:
* **AirTM:** For simple one-time donations with various payment options like Direct Bank Transfer (ACH), Debit / Credit Card via Moonpay, Stablecoins, and more than 500 banks and e-wallets.
[Donate using AirTM](https://airtm.me/lsxprime)
* **USDT (Tron/TRC20):** Supporting directly by sending to the following USDT wallet address.
```markdown
TKZzeB71XacY3Av5rnnQVrz2kQqgzrkjFn
```
**Important:** Please ensure you are sending USDT via the **TRC20 (Tron)** network. Sending funds on any other network may result in their permanent loss.
**By becoming a sponsor or making a donation, you are directly investing in the future of ProseFlow, helping to overcome critical hardware limitations and ensuring it becomes a reliable, secure, and first-class application for all users. Thank you for your generosity!**
---
### 🔧 Building from Source
#### Prerequisites
* .NET 8 SDK
* Git
#### Steps
1. Clone the repository:
```bash
git clone https://github.com/LSXPrime/ProseFlow.git
cd ProseFlow
```
2. Navigate to the UI project:
```bash
cd ProseFlow.UI
```
3. Run the application:
```bash
dotnet run
```
---
### 🛠️ Technology Stack
* **UI Framework:** [Avalonia UI](https://avaloniaui.net/)
* **UI Components:** [ShadUI.Avalonia](https://github.com/shadcn-ui/avalonia)
* **MVVM Framework:** [CommunityToolkit.Mvvm](https://learn.microsoft.com/en-us/dotnet/communitytoolkit/mvvm/)
* **Database:** [Entity Framework Core](https://learn.microsoft.com/en-us/ef/core/) with SQLite
* **Local LLM Engine:** [LLamaSharp](https://github.com/SciSharp/LLamaSharp)
* **Cloud LLM Library:** [LlmTornado](https://github.com/lofcz/LlmTornado)
* **Global Hotkeys:** [SharpHook](https://github.com/TolikPylypchuk/SharpHook)
* **Hardware Monitoring:** [LibreHardwareMonitorLib](https://github.com/LibreHardwareMonitor/LibreHardwareMonitor)
* **Dependency Injection:** [Microsoft.Extensions.DependencyInjection](https://github.com/dotnet/runtime/tree/main/src/libraries/Microsoft.Extensions.DependencyInjection)
* **Logging:** [Serilog](https://serilog.net/)
* **Update:** [Velopack](https://github.com/velopack/velopack)
---
### 🤝 Contributing
Contributions are welcome! Whether it's reporting a bug, suggesting a new feature, or submitting a pull request, your
help is greatly appreciated. Please check the [CONTRIBUTING.md](CONTRIBUTING.md) file for more information.
---
### 📜 License
ProseFlow is free and open-source software licensed under the **GNU Affero General Public License v3.0 (AGPLv3)**. See
the [LICENSE](LICENSE.md) file for details.
---
### 🙏 Acknowledgements
This project would not be possible without the incredible open-source libraries it is built upon. Special thanks to the
teams and contributors behind Avalonia, LLamaSharp, LlmTornado, all the other fantastic projects listed in the
technology stack, and indeed the rest of the open-source libraries empowering this project.