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:

1. 17 Binary Executables:

   • kodegen - Main MCP server (stdio proxy)
   • kodegend - Daemon service manager
   • 15 HTTP category servers (filesystem, git, github, terminal, etc.)

2. 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"

3. TLS Certificates:

   • Self-signed certificate for mcp.kodegen.ai
   • Installed in system trust store
   • Located at ~/.config/kodegen/certs/

4. Chromium Browser:

   • Managed Chromium installation (~100MB)
   • Required for citescrape web automation tools
   • Platform-specific cache location

5. 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

Platform-Specific Options

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 Support

Requirements

All Platforms

• 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

Platform-Specific Build Notes

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:

1. Stop the kodegend service
2. Remove service configuration (launchd/systemd/Windows Service)
3. Delete binaries from /usr/local/bin (macOS) or /usr/bin (Linux)
4. Remove certificates from trust store
5. Delete configuration directory (~/.config/kodegen/)
6. 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

• Homepage: https://kodegen.ai
• Documentation: https://docs.kodegen.ai
• Repository: https://github.com/cyrup-ai/kodegen-bundler-install
• Issues: https://github.com/cyrup-ai/kodegen-bundler-install/issues
• Discord: https://discord.gg/kodegen

Contributing

Contributions are welcome! Please read our Contributing Guide before submitting PRs.

Built with ❤️ by the KODEGEN.ᴀɪ team