🐋 KernelWhale

DeepSeek PWA on Steroids for SysAdmins & Pentesters

Turn DeepSeek Chat into your local command center.
Execute generated code directly on your machine with a single click.

This tool is 100% free to use.
Requires a valid DeepSeek account.
Independent project — not affiliated with or endorsed by DeepSeek.

Features • Installation • Usage • Uninstall

---

🚀 What is KernelWhale?

KernelWhale is an Electron-based wrapper for DeepSeek Chat designed for power users. It doesn't just display code—it runs it.

KernelWhale bridges the gap between AI generation and local execution. Accomplish complex tasks in just a few clicks, with the ability to consult the AI for doubts and adjustments on the fly.

• SysAdmin: Need help deploying Docker and configuring system services? or automating log rotation? Do it all without leaving the chat.
• Pentester: Launch a reverse shell or run analysis scripts instantly.
• User: Organize your Downloads folder or manage your system files.

✨ Features

• ⚡ Instant Execution: Adds a "▶ Run" button to every code block in DeepSeek.
• 🔑 No API Key Required: Works directly with your DeepSeek web account—no tokens needed.
• 🖥️ Native Terminals: Spawns real, independent terminal windows for each execution.
• 🔄 Session Management: Handle multiple shell sessions simultaneously (great for multitasking).
• 📏 Custom UI: Enhanced chat input with a custom blue drag-handle to resize the message input area exactly how you want it.
• 🔒 Local Context: Execute commands directly on your host machine (Linux/Kali).
• 🗂️ Easy History Access: Seamlessly navigate your conversation history to revisit past solutions or commands.

🖥️ Tested on

• Kali Rolling (Primary supported environment)
• Windows 11 (With Node.js pre-installed)

📋 Prerequisites

• Node.js: Required to run the application (v16+ recommended).
• npm: Generally installed with Node.js.

Kali Linux

sudo apt update -y && sudo apt install nodejs npm -y

Windows

• Node.js: Download from nodejs.org.
• Native Support: Executions use PowerShell natively.
• Note: To avoid WSL dependencies, Linux-style blocks (bash, sh, zsh) are automatically mapped to native PowerShell on Windows.

🛠️ Installation (Kali & Windows PowerShell)

Get up and running in seconds:

# Clone the repository
git clone https://github.com/err0x420/KernelWhale

# Navigate to the directory
cd KernelWhale

# Install dependencies
npm install

# Launch KernelWhale
npm start

💡 Windows PowerShell note: If npm install fails with "npm.ps1 cannot be loaded because running scripts is disabled on this system", open a PowerShell as Administrator and run:

Set-ExecutionPolicy Unrestricted

Answer Y when prompted, then close the terminal and run npm install again.

🎮 Usage

⚠️ Login Note: Google Login is currently not supported.

💡 Workaround: If you used Google to sign up, click "Forgot password?" on the login screen. You'll receive an email to set a password, enabling you to log in with your email and new password in KernelWhale.

1. Ask DeepSeek: "Show me how to list all open ports" or "Sort my Downloads folder by date".
2. Review: Check the code block generated by the AI.
3. Click Run: Hit the ▶ Run button injected into the code block.
4. Execute: A terminal window opens and runs your command instantly.
5. Resize: Drag the blue line above the chat input to expand your typing area.

🗑️ Uninstall (Kali Linux)

1. Close KernelWhale.

2. (Optional) Only if you used one of the installers (the .deb package or the AppImage) — otherwise you can skip this step:

   • .deb package → remove it with dpkg (commands below).
   • AppImage version → there is no uninstall entry; simply delete the .AppImage file.
   • Running from source (npm install / npm start) → there is no installed app; just delete the project folder.

   If you installed the .deb, run:

   # Find this app's package (kernel-whale only — the real Kali kernel packages are NOT matched)
   dpkg -l | grep kernel-whale
   
   # Remove the package
   sudo dpkg -r kernel-whale
   
   # Clean up leftover system files (app folder, /usr/bin symlink, menu entry)
   sudo rm -rf /opt/KernelWhale
   sudo find /usr/bin -maxdepth 1 -iname "*kernelwhale*" -delete
   sudo find /usr/share/applications -iname "*kernelwhale*" -delete

3. Remove leftover data and cache (required in all cases — user data is kept on purpose). Run:

   # App data (installed app) and leftover dev profile, just in case
   rm -rf ~/.config/KernelWhale
   rm -rf ~/.config/kernel-whale
   
   # Residual temporary execution scripts (if any remain)
   rm -f /tmp/whale_exec_*

🗑️ Uninstall (Windows 11)

1. Close KernelWhale (also check the system tray, bottom-right corner).
2. (Optional) Only if you used one of the installers (KernelWhale_Setup.exe or KernelWhale_Portable.exe) — otherwise you can skip this step:
   • Setup version (KernelWhale_Setup.exe) → Settings → Apps → Installed apps → KernelWhale → Uninstall.
   • Portable version (KernelWhale_Portable.exe) → there is no uninstall entry; simply delete the .exe file.
3. Remove leftover data and cache (required in all cases — user data is kept on purpose). Open a normal PowerShell (no admin needed) and run:

# App data (installed app) and leftover dev profile, just in case
Remove-Item "$env:APPDATA\KernelWhale"     -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item "$env:APPDATA\kernel-whale"    -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item "$env:LOCALAPPDATA\KernelWhale"    -Recurse -Force -ErrorAction SilentlyContinue

# Shortcuts if any remain
Remove-Item "$env:APPDATA\Microsoft\Windows\Start Menu\Programs\KernelWhale" -Recurse -Force -ErrorAction SilentlyContinue

# Residual temporary execution scripts (if any remain)
Remove-Item "$env:TEMP\whale_exec_*" -Force -ErrorAction SilentlyContinue

💡 Note: -ErrorAction SilentlyContinue keeps the commands silent if a folder doesn't exist — it's normal for some of them to be missing. KernelWhale doesn't install services, drivers, or system-wide entries, so nothing else needs to be removed.

📝 Roadmap

• Add support for Windows 11
• Add ability to edit code before execution
• Add support for other Linux distributions
• Fix Google OAuth Login
• Implement In-App Search

🔧 For Developers

• Versioning: This project uses ISO-8601 date versioning (e.g. 2026.8.13) instead of classic semver.
• allowScripts (in package.json): pre-approves Electron's postinstall script (it downloads the binary) for npm ≥ 11.10 / npm 12, where dependency install scripts are blocked by default. It is name-only (true) so future Electron upgrades keep working. Older npm versions silently ignore this field.
• .npmrc: loglevel=error keeps npm install output clean for new users. It hides cosmetic deprecation warnings from electron-builder's internal dependency chain (glob@7, inflight, boolean, rimraf — all unfixable upstream). The security audit summary still prints. To see all warnings, run npm install --loglevel=warn.

⚠️ Disclaimer

KernelWhale executes code on your local machine. Always review the code generated by the AI before clicking "Run". Use responsibly and only on systems you own or have permission to test.

KernelWhale is an independent project and is not affiliated with, endorsed by, or sponsored by DeepSeek *.deepseek.com and related names are trademarks of their respective owners.

---

Made with ❤️ for the SysAdmin & Hacking Community