# enikk **Repository Path**: gtt116/enikk ## Basic Information - **Project Name**: enikk - **Description**: Self-improving GUI Agent for desktop automation. Progressive perception, natural language teachable, 100% open source. Mirrored from https://github.com/gtt116/enikk - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-06-04 - **Last Updated**: 2026-06-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

Enikk Logo

# Enikk **Self-improving GUI Agent Framework for desktop automation.** [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/) [![Platform](https://img.shields.io/badge/platform-Windows%2010%2F11-lightgrey)]() Enikk is an AI agent that watches your screen, understands what it sees, and operates any desktop application — autonomously. It learns from experience, extracts reusable skills, and gets smarter every time you use it.

Enikk Dashboard

--- ## ✨ Key Features ### 🧠 Self-improving After each task, Enikk automatically reviews what happened and extracts reusable skills into persistent memory. The agent gets smarter the more you use it. ### 💰 Smart & Cost-efficient Enikk uses a multi-layer perception system (YOLO + OCR + VLM) that minimizes AI costs. Most operations never need expensive vision models — saving you money. ### ⚡ Zero Code Required Configure everything through the Web Dashboard. No programming, no scripts, no YAML editing — just point-and-click setup. ### 🖥️ Multi-app Support Control multiple applications simultaneously. Enikk auto-discovers windows and can switch between apps during a task. ### 📱 Remote Control via IM Control Enikk from your phone through chat. Send a task via QQ, and Enikk executes it on your PC while you're away. ### 👁️ Fully Observable Watch every step in the Web Dashboard: screenshots, detected elements, reasoning, and actions. No black boxes — complete transparency. ### 🔒 Local & Private Runs entirely on your machine. Your data, screenshots, and credentials never leave your computer (except for AI API calls). --- ## 📸 Demo

https://github.com/user-attachments/assets/32ca3e94-fdd5-4e8d-b3d2-19222fd437c6 Model Configuration - Point-and-click setup

https://github.com/user-attachments/assets/9ac22c98-672d-4652-9f17-258476152cc2 IM Configuration - Connect QQ Bot for remote control

Netease Cloud Music
Real-world Demo - Enikk controlling Netease Cloud Music
▶ Watch demo on YouTube

--- ## 🏗 Architecture **Data flow:** 1. **Capture** — Take a screenshot of the target application window 2. **Parse** — YOLO detects UI elements, OCR reads text, results normalized to `[0,1000]` coordinates 3. **Decide** — LLM analyzes structured data and decides what to do 4. **Act** — Click, type, or wait based on the decision --- ## 🚀 Getting Started ### Download & Run 1. **Download** the latest release from [GitHub Releases](https://github.com/gtt116/enikk/releases) 2. **Extract** the zip file 3. **Run** `enikk.exe` as Administrator (UAC prompt will appear) 4. **Open** — the dashboard opens automatically in a native window That's it. No installation, no Python, no dependencies. > [!NOTE] > Administrator privileges are required to control application windows and perform automated operations. --- ## 💬 Community Join our QQ group for questions, feedback, and updates:

QQ Group

--- ## 🎮 Supported Applications Enikk can control **any Windows desktop application**: | App | Status | |---|---| | NIKKE | ✅ Built-in | | Wuthering Waves | ✅ Built-in | | Any Windows app | ✅ Custom | --- ## 🛠 For Developers ### Build from Source ```bash # Install Git LFS first (for model weights) git lfs install git clone https://github.com/gtt116/enikk.git cd enikk uv venv --seed uv pip install -e . enikk ``` ### Build Executable ```powershell # Debug build (with console) .\build.bat # Release build (without console) .\build.bat --release ``` Generated files: - Debug mode: `dist/enikk-debug/enikk-debug.exe` - Release mode: `dist/enikk/enikk.exe` and `dist/enikk.zip` > [!IMPORTANT] > Release executable requires administrator privileges (UAC) to run. It will prompt for confirmation when launched. --- ## 📦 Dependencies & Credits Enikk stands on the shoulders of giants: | Project | License | Role | |---|---|---| | [Hermes Agent](https://github.com/NousResearch/hermes-agent) (NousResearch) | MIT | AI Agent framework, tool system, memory, IM Platform | | [OmniParser](https://github.com/microsoft/OmniParser) (Microsoft) | CC-BY-4.0 | YOLO model weights for UI element detection | | [RapidOCR](https://github.com/RapidAI/RapidOCR) | Apache 2.0 | ONNX-based Chinese OCR engine | Enikk's own code is **MIT License** — see [LICENSE](LICENSE). --- ## ⚠️ Disclaimer This project is intended for **learning and research purposes only**. Do NOT use this project in violation of any laws, game terms of service, or for any illegal purposes. Users bear full responsibility for any consequences arising from the use of this project. --- ## 📄 License MIT License — see [LICENSE](LICENSE) for details.