+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
#69Projects using Rhai31 comments · 2018-04-07#52Futures31 comments · 2017-11-05#488Type hints25 comments · 2021-11-15#451Rhai standard library.17 comments · 2021-09-23#32Advanced threads and actors9 comments · 2017-10-14#894Rhai is unsound (use after free)8 comments · 2024-07-03#537Consider adding to github/linguist6 comments · 2022-03-14#769How do I checkpoint and resume Rhai evaluation?4 comments · 2023-10-24
Discussions
#1103Prevent access chain updates?2 comments · 2026-06-09#1078Embedded Rhai in a Postgres migration linter for custom lint rules2 comments · 2026-04-07#1075rhai is listed on Shypd — AI Tool Directory0 comments · 2026-03-30#1053Highlighting Rhai syntax in my own app2 comments · 2025-11-11#1045I can't figure out why my code returns a syntax error1 comments · 2025-10-24#1044Null handling in Rhai3 comments · 2025-10-21#1041When next version will be released?2 comments · 2025-10-14#1035Support transpiling to Rhai with `#line` or equiv?3 comments · 2025-10-06
Latest release
Version 1.27.0 v1.27.0 2026-10-21This 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