WebFlow Runtime Project

---

Documentation languages

Documentation for this project (including README.md) is provided in two forms, in two different languages:

• English version (this and the main one)
• Russian version - Click to go

---

Warning

Project Under Development!

This software is not yet intended for daily use — only dev builds are currently available.

If you are testing the application and encounter any bugs or issues, please report them by opening a GitHub Issue.

---

The Ultra-Lightweight Web Application Engine & Desktop Runtime

WebFlow Runtime is a powerful ecosystem designed to seamlessly transform any website into a standalone desktop application. Engineered as an efficient alternative to traditional PWAs and resource-heavy browser wrappers, it delivers a high-performance desktop experience with a fraction of the RAM usage.

Project Philosophy

WebFlow Runtime was originally conceived as a simple, lightweight alternative to standard Progressive Web Apps (PWAs). However, as modern web apps grew increasingly resource-hungry, the project evolved into a comprehensive, feature-rich runtime environment.

My core objective is to give users full control over their web-based software: running web services as true desktop applications without sacrificing system resources, while offering both deep customization and high accessibility for power users and casual users alike.

Key Features

• Extremely Low Memory Footprint: Turns any website into a desktop app with significantly lower RAM consumption compared to standard PWAs and Chromium-based wrappers.
• WebFlow Runtime Manager (GUI): A modern, sleek graphical interface for managing, configuring, launching, and organizing all your web applications in one place.
• Full CLI Support: Complete command-line capability allowing advanced users to create, configure, and launch applications without running the GUI manager.
• Granular Customization: Fine-tune app behavior, preferences, and parameters directly through the GUI settings or manually via configuration files.
• Application Templates: Built-in templates to fast-track application setup and deployment.
• Bilingual Interface: Native out-of-the-box support for both English and Russian languages.

Roadmap

We are actively refining WebFlow Runtime. Key priorities for upcoming releases include:

• CLI Enhancements: Expanding command set, automation workflows, and terminal output controls.
• Template Expansion: Improved presets and custom template creation mechanisms.
• OAuth Authentication: Fixes and stabilization for external web authentication flows.
• Cookie Import Overhaul: Fixing and streamlining cookie file imports from major web browsers.
• Performance Optimizations: Core engine enhancements for faster launch times and reduced CPU overhead.
• GUI Redesign & Themes: Visual UI refinements and support for customizable interface themes.

---

Getting Started & Installation

Option 1: Quick Start (Pre-built Dev Build)

1. Navigate to the Releases section of this repository.
2. Download the latest portable dev build archive for your OS.
3. Unpack the archive and run the executable file.

Option 2: Building from Source

Linux

# Clone the repository
git clone https://github.com/Kyreesemm/webflow-runtime.git
cd webflow-runtime

# Create and activate a Python 3.12 virtual environment
python3.12 -m venv venv
source venv/bin/activate

# Install dependencies (use requirements-dev.txt for development)
pip install -r requirements.txt

# Run the automated build script
python dev/scripts/build.py

# Copy the app icon to the build folder (recommended)
cp docs/resources/icon.png dist/

Windows

:: Clone the repository
git clone https://github.com/Kyreesemm/webflow-runtime.git
cd webflow-runtime

:: Create and activate a Python 3.12 virtual environment
py -3.12 -m venv venv
venv\Scripts\activate

:: Install dependencies (use requirements-dev.txt for development)
pip install -r requirements.txt

:: Run the automated build script
python dev/scripts/build.py

:: Copy the app icon to the build folder (recommended)
copy docs\resources\icon.png dist\

Note: The compiled executable will be placed inside the dist/ folder. You can also run the project directly without building by executing python source/main.py in your activated environment.

---

You can also watch

In the docs/ folder, in addition to the Russian version of the README, there is some brief documentation on the project's CLI interface, also available in Russian and English, which may be useful to many people. It's also possible that additional documentation will be added there soon.

---

Tech Stack

• Core Language: Python 3.12+
• GUI Framework: PyQt6 (window management, system integration, and desktop runtime)
• Web Rendering Engine: QtWebEngine (Chromium-powered engine for fast page rendering)
• Manager UI Technologies: Pure HTML5, CSS3, and JavaScript (lightweight custom interface without heavy frontend frameworks)

---

Development by Kyreesemm (KRM Tech Software)