Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐝 Hive Runtimes

Managed runtime distributions for Hive

Hive Logo


✨ About

Hive Runtimes provides versioned, portable, and production-ready runtime environments used by Hive.

Instead of relying on system-installed runtimes, Hive downloads and manages isolated environments per version and language — ensuring consistency, stability, and zero configuration conflicts across all your development projects.


🎯 Purpose

This repository contains:

  • ✅ Versioned runtime builds for multiple languages
  • ✅ Cross-platform distributions (Windows / Linux / macOS)
  • ✅ Hive-compatible configurations
  • ✅ Release assets for automated runtime downloads
  • ✅ Version manifest for Hive Runtime Manager

📦 Supported Runtimes

🟣 PHP

  • Versions: 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4
  • Format: ZIP (Windows) / tar.gz (Linux/macOS)
  • Extensions: curl, json, mbstring, openssl, pdo_mysql, pdo_sqlite, zip, fileinfo, sodium, opcache

🟢 Node.js

  • Versions: 18.x, 20.x, 21.x, 22.x, 23.x
  • Format: ZIP (Windows) / tar.gz (Linux/macOS)
  • Includes: npm, npx, corepack

🟦 Python

  • Versions: 3.9, 3.10, 3.11, 3.12, 3.13
  • Format: ZIP (Windows) / tar.gz (Linux/macOS)
  • Includes: pip, venv

🟧 Composer

  • Version: Latest (2.x)
  • Format: PHAR
  • Purpose: PHP dependency manager

🟥 Laravel

  • Version: Latest (11.x)
  • Format: PHAR
  • Purpose: Laravel CLI installer

🔗 Runtime Symlinks

Hive automatically creates executable symlinks in:

~/.hive/bin/
Runtime Symlink Example Usage
PHP 8.3 php83 php83 --version
PHP 8.4 php84 php84 artisan serve
Node 22 node22 node22 app.js
Node 20 node20 node20 npm start
Python 3.12 python312 python312 script.py
Composer composer composer install
Laravel laravel laravel new project

Windows: Creates .bat files
Linux/macOS: Creates .sh files with executable permissions


🗂️ Version Manifest

Hive reads the manifest.json file to determine:

  • Available versions for each runtime
  • Supported platforms
  • Download URLs for each build
  • Extension recommendations
  • System requirements

🛠️ Supported Platforms

Platform Architecture Status
Windows 10/11 x64
Linux (Ubuntu 22.04+) x86_64
Linux (Other distros) x86_64 🔜 Planned
macOS x64 / arm64
macOS x64

📋 Included Packages

PHP Extensions (enabled by default):

curl, json, mbstring, openssl, pdo_mysql, pdo_sqlite, zip, fileinfo, sodium, opcache

PHP Recommended Extensions (configurable):

gd, intl, redis, imagick, xdebug

Node.js Global Packages (available via npm):

npm, npx, corepack

Python Packages (available via pip):

pip, setuptools, venv


⚙️ Default Runtime Configurations

PHP (php.ini)

Setting Value
memory_limit 256M
max_execution_time 30
upload_max_filesize 2M
post_max_size 8M
date.timezone UTC
opcache.enable 1
opcache.memory_consumption 128M

Node.js

  • npm prefix: Global packages installed to ~/.hive/npm-global
  • Cache: ~/.hive/npm-cache

Python

  • Virtual Environment: Projects use ~/.hive/venvs/<project>/
  • pip cache: ~/.hive/pip-cache

🔐 Philosophy

  • No system pollution
  • No dependency conflicts
  • Isolated per-version runtimes
  • Fast switching between versions
  • Predictable development environments
  • Language-agnostic approach
  • Developer-first experience

🚀 How Hive Uses This Repository

  1. Application Launch: Hive checks ~/.hive/runtimes/ for installed runtimes
  2. Missing Runtime: Reads manifest.json from this repository
  3. Downloads: Fetches appropriate asset for your OS/architecture
  4. Extracts: Places files in ~/.hive/runtimes/<runtime>/<version>/
  5. Links: Creates executable symlinks in ~/.hive/bin/
  6. Ready: Runtime available for projects and terminal

🔄 Automated CI/CD

This repository uses GitHub Actions to:

  • Build runtimes for all platforms
  • Create versioned releases
  • Update manifest.json
  • Sign and verify integrity

📊 Runtime Lifecycle

┌─────────────────┐
│  User Requests  │
│  Runtime Install│
└────────┬────────┘
         ▼
┌─────────────────┐
│  Check if exists│
│  in ~/.hive/    │
└────────┬────────┘
         ▼
┌─────────────────┐
│  Read manifest  │
│  from repository│
└────────┬────────┘
         ▼
┌─────────────────┐
│  Download asset │
│  for OS/ARCH    │
└────────┬────────┘
         ▼
┌─────────────────┐
│  Extract to     │
│  ~/.hive/       │
└────────┬────────┘
         ▼
┌─────────────────┐
│  Create symlink │
│  in ~/.hive/bin/│
└────────┬────────┘
         ▼
┌─────────────────┐
│  Ready to use!  │
│  php83 --version│
└─────────────────┘

🏢 Organization

Part of the LaraPire ecosystem — building modern developer infrastructure.


📄 License

Distributed under the MIT License.


🤝 Contributing

Runtime updates and improvements are welcome.
Open an issue or submit a pull request.


🐝 Powering Hive with clean, isolated, and managed runtime environments.

About

Hive runtime distribution repository. Pre-compiled PHP, Node.js, Composer, Laravel binaries for offline installation and version management. Cross-platform support for Windows, Linux, and macOS.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors