Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

314 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Enikk Logo

Enikk

Open-source Computer Use Agent that works for Any App (GUI or CLI) by Any Model (Vision or Text).

License: MIT Python 3.11+ Platform

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

๐Ÿง  Learns from Experience

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

enikk-model-configuration-h265.mp4

Model Configuration - Point-and-click setup

enikk-im-configuration-h265.mp4

IM Configuration - Connect QQ Bot for remote control

Netease Cloud Music
Real-world Demo - Enikk controlling Netease Cloud Music
โ–ถ Watch demo on YouTube


๐Ÿ’ฌ Community

Join us for questions, feedback, and updates:

Discord QR Code ย ย ย ย  QQ Group

Discordย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย ย QQ Group (627417852)


๐Ÿ— 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
  2. Unblock โ€” Right-click the zip โ†’ Properties โ†’ Check "Unblock" โ†’ OK
  3. Extract the zip file (see INSTALL.txt in the extracted folder for details)
  4. Run enikk.exe
  5. Open โ€” the dashboard opens automatically in a native window

That's it. No installation, no Python, no dependencies.

Important

Windows marks downloaded files as "from the internet" which may block execution. Always unblock the zip (step 2) before extracting. If SmartScreen still appears, click "More info" โ†’ "Run anyway".


๐ŸŽฎ 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

# 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

# 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

๐Ÿ“ฆ Dependencies & Credits

Enikk stands on the shoulders of giants:

Project License Role
Hermes Agent (NousResearch) MIT AI Agent framework, tool system, memory, IM Platform
OmniParser (Microsoft) CC-BY-4.0 YOLO model weights for UI element detection
RapidOCR Apache 2.0 ONNX-based Chinese OCR engine

Enikk's own code is MIT License โ€” see 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 for details.

About

Open-source Computer Use Agent that works for Any App (GUI or CLI) by Any Model (Vision or Text).

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages