AKA — ComfyUI Advanced Manager

WHY AKA

ComfyUI has no built-in environment manager. Users must manually create venvs, install PyTorch, manage custom nodes, and juggle multiple Python configurations. AKA solves all of this with a single integrated interface.

Problems AKA solves:

Multiple ComfyUI installations require separate venvs — AKA creates, clones and switches between them in one click.
PyTorch version hell — AKA detects your GPU architecture (Blackwell, Ada, Ampere, Turing, Pascal, Volta), CUDA version, and suggests compatible PyTorch builds. Manual input always available.
Custom nodes are a mess — AKA scans, installs, clones and removes custom nodes with dependency tracking.
No unified monitoring — AKA provides real-time server logs, hardware stats, GPU temperature tracking with voice alerts.
Browser window clutter — AKA embeds ComfyUI directly into its interface, no external browser needed. Built-in RELOAD button.
Model management chaos — MODELs tab provides tree browser with HuggingFace download, usage analytics, auto-resume for interrupted downloads.
Workflow mess — FLOWs tab manages local workflows and syncs with official Comfy-Org/workflow_templates. New flows highlighted, one-click download.
Missing update notifications — Scheduler checks ComfyUI releases on startup and every 3 hours. Voice alert when new version found.
Wheel file hassle — WHEELs tab: import from disk, download by URL, install into active venv.
Configuration pain — AKATOOLS external editor for paths.json and settings.json with UI.

AKA is a standalone executable. No Python required. No dependencies to install. Download, run, work.

SYSTEM REQUIREMENTS & WORKFLOW

Tested Platform

AKA has been tested on Windows 11 x64. It should work on Windows 10 x64 as well.

Prerequisites

Before using AKA, install these system components. You can download them directly through AKA (MAiN tab → DOWNLOAD section) — no need to visit external websites manually:

Python 3.11+ — AKA can download the installer for you (MAiN tab → DOWNLOAD → PYTHON, versions 3.13, 3.12, 3.11). During installation, check the box "Add Python to PATH" — this is important. AKA detects installed Python versions automatically. For maximum flexibility, consider installing multiple versions (3.11, 3.12, 3.13). AKA will let you choose which one to use for each venv.

Git — required for cloning ComfyUI and custom nodes. AKA can download it automatically (MAiN tab → DOWNLOAD → GIT). No manual download needed.

That's it. NVIDIA drivers are assumed to be already installed. CUDA Toolkit and cuDNN are not required — PyTorch includes its own CUDA libraries.

Recommended Workflow

1. Install prerequisites.
Install Python (with "Add Python to PATH" checked) and Git.

2. Create a clean ComfyUI installation through AKA.
In the MAiN tab, set an empty folder as the PATH, then click CLONE. AKA will clone the latest ComfyUI from GitHub. This ensures you start with a clean, known-good installation without legacy files or conflicting dependencies.

3. Create a virtual environment.
Go to the VENVs tab, click CREATE. AKA detects your GPU architecture, driver, and CUDA version and suggests the best matching PyTorch build. Select a version from the list or enable MANUAL INPUT to enter a custom pip command. Example for a manual PyTorch install:

torch==2.8.0 torchvision==0.23.0 torchaudio==2.8.0 --index-url https://download.pytorch.org/whl/cu128

Optionally enter a description for the environment. Click INSTALL and AKA will handle the full setup — venv creation, pip upgrade, requirements installation (excluding torch packages), manager requirements, and the selected PyTorch build. Progress is displayed in the Progress Panel.

4. Launch ComfyUI.
Select your new venv in the table, configure launch flags in LAUNCH KEYS, and click SERVER START. Monitor the output in the Server Monitor panel.

5. Install custom nodes.
Use the NODEs tab to clone repositories, install requirements, and manage your node whitelist. AKA can run requirements.txt and install.py for any selected nodes.

6. Manage models.
MODELs tab — browse models tree, paste HuggingFace URL, select target folder, DOWNLOAD. Interrupted downloads auto-resume. ANALYZE shows usage statistics.

7. Manage workflows.
FLOWs tab — LOCAL submenu for ComfyUI/user/default/workflows, REPO submenu for official workflow_templates. New flows highlighted, one-click download to workflows root.

8. Switch between environments.
Create multiple venvs with different PyTorch or CUDA versions. Switch between them by checking the box in the VENVs table. Each environment is isolated — no conflicts.

File Locations

Data	Location
AKA executable	bin/AKA.exe (or AKA_Launcher.exe in root)
Settings	C:\Users\Username\AppData\Roaming\AKA\settings.json
Config paths	C:\Users\Username\AppData\Roaming\AKA\configs\paths.json
Downloaded installers	C:\Users\Username\Downloads\AKA_downloads
Wheel files	C:\Users\Username\AppData\Roaming\AKA\wheels
Flows catalog	C:\Users\Username\AppData\Roaming\AKA\flows_catalog.json
Node maps	profiles/
Browser data	C:\Users\Username\AppData\Roaming\AKA\akamfy_data

Notes

AKA does not touch your system Python. All packages are installed inside virtual environments within the ComfyUI folder.
Multiple ComfyUI installations can be managed by changing the PATH in the MAiN tab. Each installation has its own set of venvs.
The splash screen launcher (AKA_Launcher.exe) can be used as the primary entry point. It shows a loading screen while AKA starts, then closes automatically.

INSTALLATION

Download AKA_Setup.exe from Releases.
Run the installer, choose a destination folder.
A desktop shortcut is created automatically.
Launch AKA.

The program is self-contained. All components are bundled inside. Settings and data are stored in the installation folder.

MAIN WINDOW LAYOUT

The interface is divided into three vertical panels, fixed at 1300x680 pixels.

Left Panel

Progress Panel — operation log and progress bar for long tasks. ABORT button kills all active operations without touching server.
Server Monitor — real-time ComfyUI server output with warning/error counters.
HW Monitor — CPU, GPU, memory load and GPU temperature.
Server Control — START/STOP buttons with session timer.
AKAMFY Bar — AKAMFY MODE checkbox, RELOAD button (active when browser open), AKA/AKAMFY toggle button.

Center Panel

MAiN tab — path configuration, system info, component downloads, AKATOOLS launcher.
VENVs tab — virtual environment management.
MODELs tab — model browser with HuggingFace download, usage analytics, drag & drop.
NODEs tab — custom nodes manager.
FLOWs tab — workflow manager (LOCAL and REPO submenus).
TOOLs tab — Python versions, ComfyUI updates, package manager, links.
WHEELs tab — wheel file installer with ADD and DOWNLOAD.

Right Panel

AKASHI Terminal — onboard computer with menu system, command line, sound synthesizer, voice notifications, scheduler.
Logo Widget — AKA branding.
Venv Console — direct Python console for the active environment.

Top Bar

TRM block — status indicator (green = normal, red = error).
Cursor ">" — blinking prompt.
Info line — last message from the system.
"赤" square — clears the terminal line.
"aKa" block — shows version on click.

Bottom Bar

ZOOM — fullscreen mode with adaptive layout and background image with masks.
MINIMIZE — minimize to taskbar.
REFRESH — reloads all tabs and system info.
TERMINATE — stops server, plays shutdown voice, blinks, exits after 3 seconds.

MAiN TAB — PATH & SYSTEM

PATH Section

This is where you tell AKA where ComfyUI lives.

BRW — opens a folder picker dialog to select the ComfyUI directory.
ENTR — toggles manual path entry mode. Click once to edit, type the path, click again to confirm.
CLONE — if the folder does not contain a ComfyUI installation, this button clones the official repository from GitHub into the specified directory.

SYS Section

Displays complete system information:

PATH — current ComfyUI directory.
INSTALLED — YES if main.py is found.
VERSION — ComfyUI version (from git tag or comfyui_version.py).
VENV — currently active environment name.
VENVS — total number of virtual environments detected.
NODES — total number of custom node folders.
PYTHON — active system Python version.
PYTORCH — PyTorch version installed in the active venv.
PY_PATH — path to Python executable in the active venv.
GPU — GPU name, VRAM, architecture (Blackwell, Ada, Ampere, Turing, Pascal, Volta).
DRIVER — NVIDIA driver version.
CUDA — CUDA toolkit version.
cuDNN — cuDNN version.
OS — Windows version and architecture.

DOWNLOAD Section

Pre-configured download buttons for common dependencies:

PYTHON — select version and click DWNLD to download the installer. Three versions available (3.13, 3.12, 3.11).
GIT — Git for Windows installer.

All downloaded files are saved to Downloads/AKA_downloads/.

Versions are defined in configs/paths.json and can be customized with AKATOOLS.

AKATOOLS Section

AKATOOLS button launches external configuration editor:

Edit PyTorch versions and CUDA mappings
Edit GPU architecture map
Edit Python download URLs
Edit Git URL
Edit settings.json (HF token encrypted, theme, splash key, links)

VENVs TAB — ENVIRONMENT MANAGEMENT

Environments Table

Lists all virtual environments found in the ComfyUI folder. Columns:

Checkbox — select to activate this environment.
NAME — folder name (venv, venv_1, etc.) with optional description in brackets.
PYTORCH — installed PyTorch version.
CUDA — CUDA variant (e.g. 12.4, CPU).
PYTHON — Python version in the venv.
SIZE — total folder size.

Only one environment can be active at a time. Selecting one updates the Server Control, Tools packages, and Venv Console.

CREATE Button

Launches the PyTorch installation dialog:

Detects your GPU architecture, driver, and CUDA version.
Suggests the best PyTorch build for your GPU generation.
Allows manual pip command input for custom builds.
Optionally adds a description for the environment.

After confirmation, AKA performs the full setup pipeline:

Creates the venv using the active system Python.
Upgrades pip.
Installs requirements.txt (excluding torch packages).
Installs manager_requirements.txt if present.
Installs the selected PyTorch build.
Saves metadata to venv_info.json.

Progress is displayed in the Progress Panel.

LAUNCH KEYS

Checkboxes for ComfyUI launch arguments. Standard flags:

--windows-standalone-build
--enable-manager
--preview-method auto
--force-fp16
--highvram / --normalvram / --lowvram / --novram
--cpu
--disable-xformers
--verbose
--listen
--port 8188

ADD — adds a custom flag.
DEL — removes a custom flag.

Flag states are saved between sessions.

HF TOKEN

For HuggingFace authentication. ENTR toggles edit mode. The token is passed to ComfyUI as --hf-token on launch. Token is encrypted in settings.json.

MODELs TAB — MODEL MANAGER

Models Tree

Browses models/ folder. Directories on top. Columns: Name, Size, Modified, Usage.

Drag & drop — move model files between folders.
REFRESH — rescan models folder.
ANALYZE — loads usage statistics from aka_model_usage.json. Colors: green (HIGH), orange (LOW), red (NONE).
DELETE — confirmation dialog, files only. Folders preserved.

HF Download

Paste HuggingFace URL (supports ?download=true suffix), select target folder in tree, DOWNLOAD. Progress in Progress Panel. Interrupted downloads auto-resume on restart via aka_download_resume.json. ABORT cancels and removes resume file.

WHEELs TAB — WHEEL FILE INSTALLER

Wheels Table

Lists .whl files from the wheels/ folder. Columns:

Checkbox — select files to install or delete.
FILE — wheel filename.
SIZE — file size.

ADD

Multi-select .whl files from disk. Copies to wheels folder.

DOWNLOAD

Download wheel by URL. Progress in Progress Panel.

INSTALL

Installs selected wheels into the active environment using pip install.

DELETE

Confirmation dialog. Removes selected wheel files from disk.

NODEs TAB — CUSTOM NODES MANAGER

Nodes Table

Scans custom_nodes/ folder. Columns:

Checkbox — select nodes for batch operations.
NAME — folder name.
REQS — YES if requirements.txt exists.
INST.PY — YES if install.py exists.
ACTIVE — whitelist toggle for ComfyUI launch.

Operation Buttons

REQS — runs pip install -r requirements.txt for selected nodes in the active venv.
INST.PY — runs install.py for selected nodes.
DELETE — confirmation dialog. Removes selected node folders.

Map Management

SAVE MAP — exports the active nodes list to a JSON file.
LOAD MAP — imports a saved map, activating only matching installed nodes.
ALL — activates all nodes in the whitelist.
NONE — deactivates all nodes.

Clone Section

URL field — paste a GitHub repository URL.
ENTR — toggles edit mode.
CLONE — clones the repository into custom_nodes/.

The whitelist system generates --disable-all-custom-nodes and --whitelist-custom-nodes flags for ComfyUI launch.

FLOWs TAB — WORKFLOW MANAGER

LOCAL Submenu

Browses ComfyUI/user/default/workflows:

Directories always on top
NEW DIR — create folder
DELETE — confirmation dialog, files only
Drag & drop — move flows between folders
MOVE — select destination folder dialog

REPO Submenu

Syncs with Comfy-Org/workflow_templates:

New flows highlighted green, existing orange
DOWNLOAD — saves selected flows to workflows root
Filter by name
Catalog stored in flows_catalog.json

TOOLs TAB — TOOLS & UTILITIES

PYTHON VERSIONS

Detects all Python installations from Windows registry and filesystem. Shows version buttons — click to switch the active system Python. This affects which Python is used for creating new venvs. Warning text explains impact.

COMFYUI VERSION

CURRENT — installed version (from git or comfyui_version.py).
LATEST — latest release from GitHub API.
CHECK — queries GitHub for the latest version.
UPDATE — pulls the latest tag and reinstalls requirements.
DNDATE — rolls back to a previous version from the snapshot list. Custom AKA-style dialog.
ALL VENVS — when checked, update/rollback applies to all environments.

CUSTOM VENV PACKAGES

Lists pip packages installed in the active venv. Select packages and click UNINSTALL to remove them.

USEFUL LINKS

Customizable link list. ENTR toggles edit mode for the URL field. ADD saves a new link. Click any link to open in the system browser.

SERVER MONITOR (Left Panel)

Real-time display of ComfyUI server output. Features:

Log area — shows server stdout with color coding: errors in red, warnings in orange, info in blue.
SZE — toggles font size (small/normal).
LOG — copies the entire log to clipboard.
ERR LOG — copies only error and warning lines.
ONF — toggles the monitor on/off.
CLR — clears the log and resets counters.
WRN counter — increments on warning lines.
ERR counter — increments on error/exception/traceback lines.

The monitor auto-activates when server output arrives.

HW MONITOR (Left Panel)

Hardware resource indicators updated every second:

CPU — usage percentage with dot indicator. Green under 60%, orange 60-80%, red above 80%.
GPU — utilization from nvidia-smi. Same color logic.
MEM — RAM usage percentage.
TC — GPU temperature in Celsius. Blinks when above 80 degrees.
Percent labels — numeric values next to indicators.

PROGRESS PANEL (Left Panel)

Displays operation progress for venv creation, downloads, node installation, etc.

Log area — shows operation steps with green/yellow text.
ABORT — kills all active operations. Stops downloads, git processes, pip installs. Server is stopped correctly via SERVER TERMINATE logic. HuggingFace resume file removed.
SZE — toggles font size.
LOG — copies log to clipboard.
ONF — toggles screen on/off (darkens when off).
CLR — clears the log.
Dot progress bar — 50 dots filling green as progress increases.
Percent label — numeric percentage.

AKASHI TERMINAL (Right Panel)

The onboard computer. Modeled after the MU/TH/UR 6000 interface from "Alien", hacked by the Matrix.

Power On/Off

Press ONF to boot. A vector animation plays: octagon forms, splits, then "AKASHI" letters appear. Press again to shut down.

Main Menu

Two-column navigation:

Left column: CMD, EDIT, VIEW, TOOLS, HELP
Right column: BEEP, SPEECH, CNTRL, GAMES, NFO

Navigate with 0-9 buttons (0-4 left, 5-9 right) or arrow keys. ENTR selects. ESC goes back.

CMD Mode

Command line interface for direct text commands:

splash — sets the selected image as the splash screen.
beep <quality> <wave> <notes> — plays a tone sequence. Quality: hf, 8b, cr, lf. Wave: sqr, tri, sin. Notes format: freq/duration;freq/duration.
snd on/off — global sound toggle.
beep on/off — enable/disable event beeps.
speech on/off — enable/disable voice notifications.
cntrl on/off — enable/disable server monitoring.
sched on/off — enable/disable scheduler.
sched check — force scheduler check now.
scr off — turns off the AKASHI screen. Any button press wakes it.
deft — resets AKASHI settings to default.
deft aka — resets all AKA settings to default.
info — developer contact information.
help — command list.
clear — clears the display.

BEEP Menu

PHRASES — saved tone sequences. Select and play with ENTR.
SYNTH — help screen showing synthesizer syntax.
FUNC — enables event beeps.
UNFUNC — disables event beeps.

SPEECH Menu

FUNC — enables speech for events.
UNFUNC — disables speech.

Speech plays MP3 files from assets/akaspeech/. Triggers include server start/stop, job completion, job error, GPU overheating, ComfyUI updates. Each event plays once — no looping.

CNTRL Menu

FUNC — enables CNTRL monitoring.
UNFUNC — disables CNTRL.

VIEW Menu

Image browser. Lists PNG files from the bundled assets. The splash command sets the viewed image as the splash screen. Hidden images (marked with *) unlocked via unlock command or gameplay.

GAMES Menu

ARKANOID — vector breakout game. Control with AKASHI arrows or keyboard. Every 100 points unlocks a hidden image. ESC exits.

NFO Menu

Displays program information and credits.

EDIT Menu

ONSTART — auto-boot AKASHI on launch.
OFSTART — manual boot.
ONSND — sound enabled by default.
OFSND — sound disabled by default.

TOOLS Menu

AKASKY ANTVIR — humorous fake antivirus scanner.

SND Button

Global sound toggle.

AKAMFY BROWSER (Embedded ComfyUI)

Toggle between AKA tabs and the ComfyUI interface using the AKAMFY MODE checkbox and the AKAMFY >>> button.

RELOAD button — reloads ComfyUI page. Active only when browser is open.

The browser loads http://localhost:8188. Supports WebGL, file downloads, persistent storage, session persistence.

beforeunload dialogs suppressed.

CONTACTS

Telegram: @Rimor_Spectator
GitHub: github.com/Rimor-dev

Name		Name	Last commit message	Last commit date
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation