rhaiscript /rhai

Rhai - An embedded scripting language for Rust.

★ 5,811⑂ 263👁 24⑃ 666● 504▤ 77
RustApache-2.0Created 2016-02-29crates.io/crates/rhai
Download: Version 1.27.0Version-1.27.0 ↓1.27.02026-10-21
+2
Daily
5,811
stars
263
forks
24
watchers
666
prs
504
issues
77
releases

README

Rhai - Embedded Scripting for Rust
==================================

!GitHub last commit














Rhai is an embedded scripting language and evaluation engine for Rust that gives a safe and easy way
to add scripting to any application.


Targets and builds
------------------

 All CPU and O/S targets supported by Rust, including:
   WebAssembly (WASM)
   no-std
 Minimum Rust version 1.66.0


Standard features
-----------------

 Simple language similar to JavaScript+Rust with dynamic typing.
 Fairly efficient evaluation - 1 million iterations in 0.14 sec on a single-core 2.6 GHz Linux VM running this script by the standard AST walker.
 Rhai Grain bytecodes compiler and VM for even faster evaluation (around 1.8-2x). Enable with the grain feature.
 Tight integration with native Rust functions and types, including getters/setters, methods and indexers.
 Freely pass Rust values into a script as variables/constants via an external Scope - all clonable Rust types are supported; no need to implement any special trait. Or tap directly into the variable resolution process.
 Built-in support for most common data types including booleans, integers, floating-point numbers (including Decimal), strings, Unicode characters, arrays (including packed byte arrays) and object maps.
 Easily call a script-defined function from Rust.
 Relatively little unsafe code (yes there are some for performance reasons).
 Few dependencies - currently only smallvec, thin-vec, num-traits, once_cell, ahash, bitflags and smartstring.
 Re-entrant scripting engine can be made Send + Sync (via the sync feature).
 Compile once to AST form for repeated evaluations.
 Scripts are optimized (useful for template-based machine-generated scripts).
 Easy custom API development via plugins system powered by procedural macros.
 Function overloading and operator overloading.
 Dynamic dispatch via function pointers with additional support for currying.
 Closures (anonymous functions) that can capture shared values.
 Some syntactic support for object-oriented programming (OOP).
 Organize code base with dynamically-loadable modules, optionally overriding the resolution process.
 Serialization/deserialization support via serde (requires the serde feature).
 Support for minimal builds by excluding unneeded language features.
 A debugging interface.


Protected against attacks
-------------------------

 _Don't Panic_ guarantee - Any panic is a bug. Rhai subscribes to the motto that a library should never panic the host system, and is coded with this in mind.
 Sand-boxed - the scripting engine, if declared immutable, cannot mutate the containing environment unless explicitly permitted.
 Rugged - protected against malicious attacks (such as stack-overflow, over-sized data, and runaway scripts etc.) that may come from untrusted third-party user-land scripts.
 Track script evaluation progress and manually terminate a script run.
 Passes Miri.


For those who actually want their own language
---------

Top issues

Discussions

Latest release

Version 1.27.0 v1.27.0 2026-10-21
This is a big release that officially remove the _experimental_ qualifier to the Rhai Grain transpiler and VM.

A new feature, no_ast is added to completely remove the AST, parser, tokenizer and optimizer from the build.  Such a build can only run Rhai Grain bytecodes; it cannot parse Rhai script text.

_Lazy-loading_ is now also supported natively in all modes.  Lazy-loaded modules only look up functions when they're being called, thus substantially cutting down runtime footprint.

There are a large number of bug fixes as well, in addition to some performance improvements.

Bug fixes

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON