{"id":13484173,"url":"https://github.com/oracle/truffleruby","last_synced_at":"2025-05-13T20:22:08.576Z","repository":{"id":37828373,"uuid":"51164398","full_name":"oracle/truffleruby","owner":"oracle","description":"A high performance implementation of the Ruby programming language, built on GraalVM.","archived":false,"fork":false,"pushed_at":"2025-04-23T18:02:37.000Z","size":306486,"stargazers_count":3103,"open_issues_count":181,"forks_count":191,"subscribers_count":75,"default_branch":"master","last_synced_at":"2025-04-28T11:55:21.572Z","etag":null,"topics":["graalvm","hacktoberfest","ruby","truffle"],"latest_commit_sha":null,"homepage":"https://www.graalvm.org/ruby/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oracle.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-02-05T18:03:11.000Z","updated_at":"2025-04-27T15:49:27.000Z","dependencies_parsed_at":"2023-02-17T04:01:44.410Z","dependency_job_id":"e8194db3-6cd4-42ea-98b0-5bf7d6744d1e","html_url":"https://github.com/oracle/truffleruby","commit_stats":{"total_commits":61269,"total_committers":482,"mean_commits":"127.11410788381743","dds":0.7737028513603943,"last_synced_commit":"0d0c7678c54f14630c4ded6a730f138c68a27fe7"},"previous_names":[],"tags_count":204,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Ftruffleruby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Ftruffleruby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Ftruffleruby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Ftruffleruby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle","download_url":"https://codeload.github.com/oracle/truffleruby/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251311332,"owners_count":21569008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["graalvm","hacktoberfest","ruby","truffle"],"created_at":"2024-07-31T17:01:20.229Z","updated_at":"2025-04-28T11:55:58.427Z","avatar_url":"https://github.com/oracle.png","language":"Ruby","readme":"![TruffleRuby logo](logo/png/truffleruby_logo_horizontal_medium_outlined.png)\n\nTruffleRuby is the [GraalVM](http://graalvm.org/) high-performance implementation\nof the [Ruby programming language](https://www.ruby-lang.org/en/).\n\n## Getting Started\n\nTruffleRuby comes in two distributions:\n\n* Native Standalone: This only contains TruffleRuby in the [Native configuration](#truffleruby-runtime-configurations).\n* JVM Standalone: This only contains TruffleRuby in the [JVM configuration](#truffleruby-runtime-configurations).\n  This includes support for other languages such as Java, JavaScript, Python and WebAssembly.\n\nYou can install either of those:\n\n* Via your [Ruby manager/installer](doc/user/ruby-managers.md) (RVM, rbenv, chruby, asdf, ruby-build, ruby-install).  \n  We recommend trying TruffleRuby dev builds which contain the latest fixes and improvements (replace `VERSION` by `dev`).\n\nNative Standalone:\n```bash\nRVM:    $ rvm install truffleruby # or truffleruby-head\nrbenv:  $ rbenv install truffleruby-VERSION\nasdf:   $ asdf install ruby truffleruby-VERSION\nchruby: $ ruby-install truffleruby\n        $ ruby-build truffleruby-VERSION ~/.rubies/truffleruby-VERSION\n```\nJVM Standalone:\n```bash\nrbenv:  $ rbenv install truffleruby+graalvm-VERSION\nasdf:   $ asdf install ruby truffleruby+graalvm-VERSION\nchruby: $ ruby-install truffleruby-graalvm\n        $ ruby-build truffleruby+graalvm-VERSION ~/.rubies/truffleruby+graalvm-VERSION\n```\n\n* In CI with GitHub Actions, see [Testing TruffleRuby in CI](doc/user/testing-truffleruby-in-ci.md) for more details and other CIs.\n\n```yaml\n- uses: ruby/setup-ruby@v1\n  with:\n    ruby-version: truffleruby # or truffleruby-head or truffleruby+graalvm or truffleruby+graalvm-head\n```\n\n* Via Docker.\n  For Native Standalone see [official release images](https://github.com/graalvm/container/blob/master/truffleruby-community/README.md)\n  and [nightly images](https://github.com/flavorjones/truffleruby/pkgs/container/truffleruby).\n  For JVM Standalone there are no Docker images yet, but you can easily [download it](doc/user/installing-truffleruby.md) and take inspiration from the [Native Standalone Dockerfiles](https://github.com/flavorjones/truffleruby/blob/master/tool/dockerfiles/stable.dockerfile).\n\n* Manually, by following the [documentation](doc/user/installing-truffleruby.md).\n\nYou can use `gem` and `bundle` to install gems, as usual.\n\nPlease report any issues you might find on [GitHub](https://github.com/oracle/truffleruby/issues).\n\n## Aim\n\nTruffleRuby aims to:\n\n* Run idiomatic Ruby code faster.\n  * TruffleRuby is the [fastest Ruby implementation](https://eregon.me/blog/2022/01/06/benchmarking-cruby-mjit-yjit-jruby-truffleruby.html) for many CPU-intensive benchmarks.\n* Run Ruby code in parallel.\n  * TruffleRuby does not have a global interpreter lock and runs Ruby code in parallel.\n* Support C extensions.\n  * Many C extensions work out of the box, including database drivers.\n* Add fast and low-overhead interoperability with languages like Java, JavaScript, Python and WebAssembly.\n  * Provided by GraalVM, see the [Polyglot documentation](doc/user/polyglot.md).\n* Provide new tooling, such as debuggers and monitoring, that works across languages.\n  * Includes a profiler, debugger, VisualVM, and more. See the [Tools documentation](doc/user/tools.md).\n* Provide all of the above while maintaining very high compatibility with the standard implementation of Ruby.\n\n## TruffleRuby Runtime Configurations\n\nThere are two main runtime configurations of TruffleRuby, Native and JVM, which have different trade-offs.\n\n| Configuration: | Native (`--native`, default) | JVM (`--jvm`) |\n| ------------------ | ------------: | ------------: |\n| Time to start TruffleRuby | about as fast as MRI startup | slower |\n| Time to reach peak performance | faster | slower |\n| Peak performance (also considering GC) | good | best |\n| Java host interoperability | needs reflection configuration | just works |\n\nTo find out which runtime configuration is being used, run `ruby --version` on the command line,\nor check the value of `RUBY_DESCRIPTION` or `TruffleRuby.native?` in Ruby code.\nRuntime configurations are further detailed in [Deploying TruffleRuby](doc/user/deploying.md).\n\n## System Compatibility\n\nTruffleRuby is actively tested on the following systems:\n\n* Oracle Linux 7, 8, 9\n* Ubuntu 18.04, 20.04, 22.04 (all LTS)\n* Fedora 37, 38\n* Debian 10, 11, 12\n* macOS 11 (Big Sur)\n\nArchitectures:\n\n* AMD64 (aka `x86_64`): Supported\n* AArch64 (aka `arm64`): Supported on Linux (from 21.2) and on macOS (from 22.2)\n\nYou may find that TruffleRuby will not work if you severely restrict the\nenvironment, for example, by unmounting system filesystems such as `/dev/shm`.\n\n## Dependencies\n\n* [make, gcc and g++](doc/user/installing-llvm.md) for building C and C++ extensions\n* [libssl](doc/user/installing-libssl.md) for the `openssl` C extension\n* [libyaml](doc/user/installing-libyaml.md) for the `psych` C extension\n* [zlib](doc/user/installing-zlib.md) for the `zlib` C extension\n\nWithout these dependencies, many libraries including RubyGems will not work.\nTruffleRuby will try to print a nice error message if a dependency is missing, but this can only be done on a best effort basis.\n\nYou also need to set up a [UTF-8 locale](doc/user/utf8-locale.md) if not already done.\n\nSee the [contributor workflow](doc/contributor/workflow.md) document if you wish to build TruffleRuby from source.\n\n## Current Status\n\nWe recommend that people trying TruffleRuby on their gems and applications [get in touch with us](#contact) for any help they might need.\n\nTruffleRuby runs Rails and is compatible with many gems, including C extensions.\nTruffleRuby is not 100% compatible with MRI 3.3 yet. Please [report](https://github.com/oracle/truffleruby/issues) any compatibility issues you might find.\nTruffleRuby [passes around 97% of ruby/spec](https://eregon.me/rubyspec-stats/),\nmore than any other alternative Ruby implementation.\n\nRegarding performance, TruffleRuby is [by far](https://eregon.me/blog/2022/01/06/benchmarking-cruby-mjit-yjit-jruby-truffleruby.html)\nthe fastest Ruby implementation on the [yjit-bench](https://github.com/Shopify/yjit-bench) benchmark suite which includes `railsbench`, etc.\nTo achieve this performance TruffleRuby needs a fair amount of warmup, as other advanced JIT compilers do.\nIf you find any performance issue, please see [this guide](doc/user/reporting-performance-problems.md).\n\n## Releases\n\nTruffleRuby is released at the same time as GraalVM.\nTruffleRuby continues to use the release numbering based on the calendar year, for example, 21.x, and 22.x., same as GraalVM prior to 2023.\nSee the [release roadmap](https://www.graalvm.org/release-notes/version-roadmap/) and [the upcoming releases list](https://github.com/oracle/truffleruby/milestones?state=open) for the release dates and information about how long releases are supported.\nGraalVM Community Edition releases are supported at most one year.\n[Longer support](https://docs.oracle.com/en/graalvm/enterprise/22/docs/release-calendar/) is available for Oracle GraalVM.\n\n## Migration from MRI\n\nTruffleRuby should in most cases work as a drop-in replacement for MRI, but you\nshould read about our [compatibility](doc/user/compatibility.md).\n\n## Migration from JRuby\n\nFor many use cases TruffleRuby should work as a drop-in replacement for JRuby.\nHowever, our approach to integration with Java is different to JRuby so you\nshould read our [migration guide](doc/user/jruby-migration.md).\n\n## Documentation\n\nExtensive user documentation is available in [`doc/user`](doc/user).\n\nSee our [source code repository](https://github.com/oracle/truffleruby) and\n[contributor documentation](CONTRIBUTING.md) to contribute to TruffleRuby.\nIn particular, see the [contributor workflow](doc/contributor/workflow.md)\ndocument for how to build and run TruffleRuby.\n\n## Contact\n\nThe best way to get in touch with us is to join the `#truffleruby` channel on\n[GraalVM Slack](https://www.graalvm.org/community/#community-support).\nYou can also Tweet to [@TruffleRuby](https://twitter.com/truffleruby), or email\n_benoit.daloze@oracle.com_.\n\nPlease report security vulnerabilities via the process outlined in the [reporting vulnerabilities guide](https://www.oracle.com/corporate/security-practices/assurance/vulnerability/reporting.html), rather than by something public such as a GitHub issue or a Gitter conversation.\n\n## Mailing List\n\nAnnouncements about GraalVM, including TruffleRuby, are made on the\n[graal-dev](http://mail.openjdk.java.net/mailman/listinfo/graal-dev) mailing list.\n\n## Authors\n\nThe main authors of TruffleRuby ordered by first contribution are:\nChris Seaton, Benoit Daloze, Kevin Menard, Petr Chalupa, Brandon Fish, Duncan MacGregor, Christian Wirth, Rafael França, Alan Wu, Nicolas Laurent, Carol Chen, Nikolay Sverchkov, Lillian Zhang, Tom Stuart, and Maple Ong.\n\n## Security\n\nSee [SECURITY](SECURITY.md) for how to report security vulnerabilities to Oracle.\nFor known vulnerabilities in Ruby, please refer to the [known-cves](doc/user/known-cves.md) file.\n\n## Licence\n\nTruffleRuby is copyright (c) 2013-2025 Oracle and/or its affiliates, and is made\navailable to you under the terms of any one of the following three licenses:\n\n* Eclipse Public License version 2.0, or\n* GNU General Public License version 2, or\n* GNU Lesser General Public License version 2.1.\n\nFor further licensing information, see [LICENCE](LICENCE.md), [3rd_party_licenses](3rd_party_licenses.txt), and [doc/legal/legal](doc/legal/legal.md).\n\n## Attribution\n\nTruffleRuby includes infrastructure code from [JRuby](https://github.com/jruby/jruby) (e.g. JCodings, Joni), core library code from the [Rubinius](https://github.com/rubinius/rubinius) project, as well as code from the standard implementation of Ruby, [MRI](https://github.com/ruby/ruby).\n","funding_links":[],"categories":["Ruby","Implementations/Compilers","Major Rubies"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle%2Ftruffleruby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle%2Ftruffleruby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle%2Ftruffleruby/lists"}