Universal Polyglot Runtime
Run JavaScript, TypeScript, PHP, Python, Ruby, Go, Zig, Rust, C, and C++ — all from a single runtime.

---

Quick Start

# Install globally via npm (macOS / Linux / Windows)
npm install -g klyron

# Or via curl (macOS / Linux / WSL)
curl -fsSL https://klyron.dev/install.sh | bash

# Or via PowerShell (Windows)
iwr -useb https://klyron.dev/install.ps1 | iex

# Or via Cargo
cargo install klyron-cli

# Verify installation
klyron --version

# Run your first script
klyron run hello.js

Features

• Polyglot Execution — Run 10 languages from a single runtime without manually installing separate interpreters
• Unified HTTP API — Write servers once using Klyron.serve() that work across all languages
• Built-in Package Manager — No need for npm, pip, gem; use klyron install for everything
• Scaffolding System — Generate full-stack apps, APIs, microservices, and more with klyron scaffold
• Hot Reload — Watch mode with automatic restarts on file changes
• Bundling & Transpilation — Built-in bundler and transpiler for JS/TS
• Plugin System — Extend Klyron with native Rust plugins
• AI Integration — Built-in crate for LLM-powered features (klyron_ai)
• Docker Support — Seamless containerization
• Workspace Management — Monorepo support out of the box

Usage

Run JavaScript

klyron run hello.js

Run TypeScript

klyron run hello.ts

HTTP Server

// server.js
Klyron.serve({ port: 3000 }, (req) => {
  return new Response("Hello from Klyron!", {
    headers: { "Content-Type": "text/plain" },
  });
});

klyron run server.js

Scaffold a Project

klyron scaffold my-app --template react
klyron scaffold my-api --template api

Package Management

klyron install lodash
klyron install flask
klyron install requests

Supported Languages

Language	Extension	Status
JavaScript	.js	✅
TypeScript	.ts	✅
PHP	.php	✅
Python	.py	✅
Ruby	.rb	✅
Go	.go	✅
Zig	.zig	✅
Rust	.rs	✅
C	.c	✅
C++	.cc .cpp .cxx .hpp	✅

Documentation

• Getting Started
• CLI Reference
• HTTP API
• Package Manager
• Scaffolding
• Plugin Development
• API Reference

Examples

# Clone and explore
git clone https://github.com/dextryayers/klyron.git
cd klyron/examples/01-hello-world
klyron run hello.js

Check the examples directory for:

• 01-hello-world — Polyglot hello world in 8 languages
• 02-http-server — HTTP server with Klyron's unified API
• 03-react-app — Full React frontend
• 04-laravel-app — Laravel PHP application
• 05-next-app — Next.js full-stack app
• 06-fullstack — Full-stack monolith
• 07-microservices — Microservices architecture
• 08-desktop — Desktop application

Contributing

We welcome contributions from the community!

1. Fork the repository
2. Create a branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to your branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Please read our Contributing Guide for details on our code of conduct and development process.

Development Setup

git clone https://github.com/dextryayers/klyron.git
cd klyron
cargo build
cargo test

License

This project is licensed under the MIT License — see the LICENSE file for details.

---

klyron.dev  ·  GitHub  ·  Issues  ·  Discussions