No description
Find a file
2025-08-14 17:59:27 -07:00
.github add more network settings, start detecting GPU and CPU capabilities 2025-08-14 13:11:07 -07:00
.husky Initial commit: FriendlyKobold Electron app with KoboldCpp management 2025-08-11 18:34:35 -07:00
.vscode more refactoring, buf fixes and working system tray functionality 2025-08-13 17:13:42 -07:00
assets better dummy icon, fix close to tray, implement launch tabs for more configurations, kobold lite iframe view, UX improvements and bug fixes 2025-08-14 01:25:29 -07:00
build making it better and refactoring, digging through the AI generated slop 2025-08-13 00:02:47 -07:00
src windows rocm support, warn users from suboptimal setups 2025-08-14 17:59:27 -07:00
.gitignore add more network settings, start detecting GPU and CPU capabilities 2025-08-14 13:11:07 -07:00
.prettierignore add more network settings, start detecting GPU and CPU capabilities 2025-08-14 13:11:07 -07:00
.prettierrc Initial commit: FriendlyKobold Electron app with KoboldCpp management 2025-08-11 18:34:35 -07:00
cspell.json windows rocm support, warn users from suboptimal setups 2025-08-14 17:59:27 -07:00
electron.vite.config.ts better dummy icon, fix close to tray, implement launch tabs for more configurations, kobold lite iframe view, UX improvements and bug fixes 2025-08-14 01:25:29 -07:00
eslint.config.ts windows rocm support, warn users from suboptimal setups 2025-08-14 17:59:27 -07:00
index.html better dummy icon, fix close to tray, implement launch tabs for more configurations, kobold lite iframe view, UX improvements and bug fixes 2025-08-14 01:25:29 -07:00
LICENSE making it better and refactoring, digging through the AI generated slop 2025-08-13 00:02:47 -07:00
package-lock.json windows rocm support, warn users from suboptimal setups 2025-08-14 17:59:27 -07:00
package.json windows rocm support, warn users from suboptimal setups 2025-08-14 17:59:27 -07:00
README.md windows rocm support, warn users from suboptimal setups 2025-08-14 17:59:27 -07:00
tsconfig.json Initial commit: FriendlyKobold Electron app with KoboldCpp management 2025-08-11 18:34:35 -07:00
tsconfig.main.json making it better and refactoring, digging through the AI generated slop 2025-08-13 00:02:47 -07:00
tsconfig.node.json Initial commit: FriendlyKobold Electron app with KoboldCpp management 2025-08-11 18:34:35 -07:00

FriendlyKobold

A koboldcpp manager.

Core Features

  • modern UI with full support for Linux Wayland
  • download and keep up-to-date your koboldcpp binary
  • better surface the ROCm-specific builds of koboldcpp from YellowRoseCx and from koboldai.org
  • manage the koboldcpp binary to prevent it from running in the background indefinitely

Prerequisites

  • Node.js 18+
  • npm

Setup

  1. Clone the repository

  2. Install dependencies:

    npm install
    
  3. Start the development server:

    npm run dev
    

Linux Wayland support

Additional configurations have been written to help with ideal Wayland support, but as per current Electron guidelines, the user should set ELECTRON_OZONE_PLATFORM_HINT to wayland in their environment variable according to the Electron Environment Variables documentation.

Future considerations

It would make a lot of sense to transition this project to Tauri from Electron. The app size should drop from ~80MB to ~10MB; however, users on obsolete OSes (with outdated WebViews) will very likely encounter issues. In addition, I would need to learn Rust to rewrite the BE (Electron main code), but at least we can re-use all the React code. The app would be much smaller, faster and memory efficient, but not work for some users. I think it's a worthy tradeoff.

License

AGPL v3 License - see LICENSE file for details