Readme
KODEGEN.ᴀɪ Installer
Cross-platform installer for the KODEGEN.ᴀɪ daemon service - the ultimate MCP auto-coding toolset with 75+ blazing-fast Rust-native tools.
Features
🚀 One-Command Installation - Interactive wizard guides you through setup
🔒 Secure by Default - Automatic TLS certificate generation and trust store integration
🎨 Beautiful Terminal UI - Color-coded progress bars and status messages
🌐 Cross-Platform - Supports macOS, Linux, and Windows
🤖 Chromium Integration - Automatic browser installation for web automation
⚡ Blazing Fast - Rust-powered with zero-overhead abstractions
🔄 Service Management - System daemon integration (launchd/systemd/Windows Services)
Quick Start
macOS
# Download and run installer from .app bundle
open Kodegen.app
# Or via command line
curl -fsSL https://kodegen.ai/install.sh | sh
Linux
# Debian/Ubuntu
sudo dpkg -i kodegen_0.1.0_amd64.deb
# Red Hat/Fedora/CentOS
sudo rpm -i kodegen-0.1.0.x86_64.rpm
# Or build from source
cargo install kodegen_bundler_install
kodegen_install
Windows
# Run MSI installer
kodegen- installer.msi
# Or via command line
kodegen_install.exe - - gui
What Gets Installed
The installer sets up:
17 Binary Executables :
kodegen - Main MCP server (stdio proxy)
kodegend - Daemon service manager
15 HTTP category servers (filesystem, git, github, terminal, etc.)
System Service :
macOS: LaunchDaemon at ~/Library/LaunchAgents/ai.kodegen.daemon.plist
Linux: systemd unit at /etc/systemd/system/kodegen.service
Windows: Windows Service named "Kodegen Daemon"
TLS Certificates :
Self-signed certificate for mcp. kodegen. ai
Installed in system trust store
Located at ~/.config/kodegen/certs/
Chromium Browser :
Managed Chromium installation (~100MB)
Required for citescrape web automation tools
Platform-specific cache location
Configuration :
Default config at ~/.config/kodegen/config.toml
Service definitions for 15+ HTTP servers
Health check endpoints and port assignments
Usage
Interactive Installation (Default)
Simply run the installer without arguments for an interactive wizard:
kodegen_install
You'll be prompted to configure:
Service auto-start on boot
Chromium browser installation
Certificate trust settings
Non-Interactive Installation
For CI/CD pipelines or automated deployments:
kodegen_install -- no-interaction
This uses sensible defaults:
Auto-start enabled
Chromium installed
Certificates trusted
Building from Source:
kodegen_install -- from-source -- binary ./target/release/kodegend
Package Manager Installation:
# Debian/Ubuntu (called by .deb postinst)
kodegen_install --from-platform deb --no-interaction
# Red Hat/Fedora (called by .rpm %post)
kodegen_install --from-platform rpm --no-interaction
macOS .app Bundle:
# Auto-detects bundle and extracts binaries
/Applications/Kodegen.app/Contents/MacOS/kodegen_install
Windows Installer:
# GUI mode for .msi/.nsis installers
kodegen_install.exe --from-platform msi --gui
Additional Options
# Show what would be installed without doing it
kodegen_install --dry-run
# Install without starting service
kodegen_install --no-start
# Uninstall everything
kodegen_install --uninstall
# Force GUI mode
kodegen_install --gui
Platform
Installation Method
Service Manager
Status
macOS 11+
.app bundle, Homebrew
launchd
✅ Stable
Ubuntu 20.04+
.deb package
systemd
✅ Stable
Debian 11+
.deb package
systemd
✅ Stable
Fedora 36+
.rpm package
systemd
✅ Stable
CentOS 8+
.rpm package
systemd
✅ Stable
Windows 10+
.msi installer
Windows Services
✅ Stable
Windows 11
.msi installer
Windows Services
✅ Stable
Requirements
Rust Nightly (automatically installed if missing via rustup)
~200MB free disk space (binaries + Chromium)
Internet connection (for Chromium download)
macOS
macOS 11.0 (Big Sur) or later
/usr/local/bin writable (for binary installation)
Xcode Command Line Tools (for building from source)
Linux
systemd (for service management)
glibc 2.31+ (Ubuntu 20.04+, Debian 11+)
update-ca-certificates (for certificate installation)
Windows
Windows 10 version 1809 or later
Administrator privileges (for service installation)
Visual Studio Build Tools (for building from source)
Building from Source
Prerequisites
Install Rust nightly:
curl -- proto ' =https' -- tlsv1 .2 - sSf https://sh.rustup.rs | sh
rustup install nightly
rustup default nightly
Build Steps
# Clone the repository
git clone https://github.com/cyrup-ai/kodegen-bundler-install
cd kodegen-bundler-install
# Build release binary
cargo build --release
# Run installer
./target/release/kodegen_install
Build with GUI Support (Optional)
cargo build -- release -- features gui
./target/release/kodegen_install -- gui
macOS:
Build script creates KodegenHelper. app for privilege escalation
Helper app is signed with ad-hoc signature
Requires Xcode Command Line Tools
Linux:
Build script detects systemd via pkg-config
Requires libsystemd-dev (Debian/Ubuntu) or systemd-devel (Fedora/CentOS)
Windows:
Requires Visual Studio Build Tools with C++ desktop development
Uses Windows SDK for service integration
Troubleshooting
Installation Fails with "Binary not found"
Solution: Run with --from-source to build from local repository:
kodegen_install -- from-source -- binary ./target/release/kodegend
Chromium Download Times Out
Solution: Increase timeout and retry:
KODEGEN_CHROMIUM_TIMEOUT = 1800 kodegen_install
Certificate Not Trusted
macOS: Add certificate manually to Keychain Access
Linux: Run sudo update-ca-certificates
Windows: Import certificate via certutil - addstore Root cert. pem
Service Fails to Start
Check service status:
# macOS
launchctl list | grep kodegen
# Linux
systemctl status kodegen
# Windows
sc query "Kodegen Daemon"
View logs:
# macOS
tail -f ~/Library/Logs/kodegen/daemon.log
# Linux
journalctl -u kodegen -f
# Windows
Get-EventLog -LogName Application -Source "Kodegen Daemon"
Permission Denied Errors
macOS: Run with sudo for /usr/local/bin access:
sudo kodegen_install
Linux: Ensure running as root or via package manager:
sudo kodegen_install
Windows: Run as Administrator:
Start-Process kodegen_install.exe - Verb RunAs
Uninstallation
Remove all installed components:
kodegen_install -- uninstall
This will:
Stop the kodegend service
Remove service configuration (launchd/systemd/Windows Service)
Delete binaries from /usr/local/bin (macOS) or /usr/bin (Linux)
Remove certificates from trust store
Delete configuration directory (~/.config/kodegen/ )
Remove Chromium installation
Security
Privilege Escalation
The installer requires elevated privileges on some platforms:
macOS: Uses KodegenHelper. app for authenticated installation to /usr/local/bin
Linux: Requires sudo for systemd service installation and certificate trust
Windows: Requires Administrator for Windows Service creation
The helper app is:
Code-signed (ad-hoc on macOS, Authenticode on Windows)
Validates parent process is kodegend
Enforces 1MB script size limit
Uses 5-minute timeout for all operations
Certificate Generation
Self-signed X.509 certificates are generated using:
RSA 2048-bit keys
SHA-256 signature algorithm
1-year validity period
Subject Alternative Names (SAN) for mcp. kodegen. ai and localhost
Certificates are stored at ~/.config/kodegen/certs/ with restricted permissions (600).
License
Dual-licensed under Apache-2.0 OR MIT. See LICENSE.md for details.
Links
Contributing
Contributions are welcome! Please read our Contributing Guide before submitting PRs.
Built with ❤️ by the KODEGEN.ᴀɪ team