{"id":13645026,"url":"https://github.com/gem5/gem5","last_synced_at":"2025-05-13T20:18:58.255Z","repository":{"id":24040396,"uuid":"27425638","full_name":"gem5/gem5","owner":"gem5","description":"The official repository for the gem5 computer-system architecture simulator.","archived":false,"fork":false,"pushed_at":"2025-04-28T10:34:06.000Z","size":273445,"stargazers_count":1953,"open_issues_count":137,"forks_count":1392,"subscribers_count":71,"default_branch":"stable","last_synced_at":"2025-04-28T11:57:14.890Z","etag":null,"topics":["architecture","arm","modeling","open-source","risc-v","simulation","simulator","x86"],"latest_commit_sha":null,"homepage":"http://www.gem5.org","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gem5.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":"CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-12-02T09:46:00.000Z","updated_at":"2025-04-28T07:41:02.000Z","dependencies_parsed_at":"2023-10-11T06:32:13.613Z","dependency_job_id":"3b94c528-4b75-4a5c-b0c9-d15e501c3e8b","html_url":"https://github.com/gem5/gem5","commit_stats":{"total_commits":19004,"total_committers":392,"mean_commits":48.47959183673469,"dds":0.7222689960008419,"last_synced_commit":"e9da8d67bdbb23fbd0578a379f08f42bce50121d"},"previous_names":[],"tags_count":47,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gem5%2Fgem5","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gem5%2Fgem5/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gem5%2Fgem5/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gem5%2Fgem5/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gem5","download_url":"https://codeload.github.com/gem5/gem5/tar.gz/refs/heads/stable","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":["architecture","arm","modeling","open-source","risc-v","simulation","simulator","x86"],"created_at":"2024-08-02T01:02:23.886Z","updated_at":"2025-04-28T11:57:28.023Z","avatar_url":"https://github.com/gem5.png","language":"C++","funding_links":[],"categories":["C++","Electronics Simulators","Open Source Toolchains"],"sub_categories":["Simulators/Emulators"],"readme":"# The gem5 Simulator\n\nThis is the repository for the gem5 simulator. It contains the full source code\nfor the simulator and all tests and regressions.\n\nThe gem5 simulator is a modular platform for computer-system architecture\nresearch, encompassing system-level architecture as well as processor\nmicroarchitecture. It is primarily used to evaluate new hardware designs,\nsystem software changes, and compile-time and run-time system optimizations.\n\nThe main website can be found at \u003chttp://www.gem5.org\u003e.\n\n## Testing status\n\n**Note**: These regard tests run on the develop branch of gem5:\n\u003chttps://github.com/gem5/gem5/tree/develop\u003e.\n\n[![Daily Tests](https://github.com/gem5/gem5/actions/workflows/daily-tests.yaml/badge.svg?branch=develop)](https://github.com/gem5/gem5/actions/workflows/daily-tests.yaml)\n[![Weekly Tests](https://github.com/gem5/gem5/actions/workflows/weekly-tests.yaml/badge.svg?branch=develop)](https://github.com/gem5/gem5/actions/workflows/weekly-tests.yaml)\n[![Compiler Tests](https://github.com/gem5/gem5/actions/workflows/compiler-tests.yaml/badge.svg?branch=develop)](https://github.com/gem5/gem5/actions/workflows/compiler-tests.yaml)\n\n## Getting started\n\nA good starting point is \u003chttp://www.gem5.org/about\u003e, and for\nmore information about building the simulator and getting started\nplease see \u003chttp://www.gem5.org/documentation\u003e and\n\u003chttp://www.gem5.org/documentation/learning_gem5/introduction\u003e.\n\n## Building gem5\n\nTo build gem5, you will need the following software: g++ or clang,\nPython (gem5 links in the Python interpreter), SCons, zlib, m4, and lastly\nprotobuf if you want trace capture and playback support. Please see\n\u003chttp://www.gem5.org/documentation/general_docs/building\u003e for more details\nconcerning the minimum versions of these tools.\n\nOnce you have all dependencies resolved, execute\n`scons build/ALL/gem5.opt` to build an optimized version of the gem5 binary\n(`gem5.opt`) containing all gem5 ISAs. If you only wish to compile gem5 to\ninclude a single ISA, you can replace `ALL` with the name of the ISA. Valid\noptions include `ARM`, `NULL`, `MIPS`, `POWER`, `RISCV`, `SPARC`, and `X86`\nThe complete list of options can be found in the build_opts directory.\n\nSee https://www.gem5.org/documentation/general_docs/building for more\ninformation on building gem5.\n\n## The Source Tree\n\nThe main source tree includes these subdirectories:\n\n* build_opts: pre-made default configurations for gem5\n* build_tools: tools used internally by gem5's build process.\n* configs: example simulation configuration scripts\n* ext: less-common external packages needed to build gem5\n* include: include files for use in other programs\n* site_scons: modular components of the build system\n* src: source code of the gem5 simulator. The C++ source, Python wrappers, and Python standard library are found in this directory.\n* system: source for some optional system software for simulated systems\n* tests: regression tests\n* util: useful utility programs and files\n\n## gem5 Resources\n\nTo run full-system simulations, you may need compiled system firmware, kernel\nbinaries and one or more disk images, depending on gem5's configuration and\nwhat type of workload you're trying to run. Many of these resources can be\nobtained from \u003chttps://resources.gem5.org\u003e.\n\nMore information on gem5 Resources can be found at\n\u003chttps://www.gem5.org/documentation/general_docs/gem5_resources/\u003e.\n\n## Getting Help, Reporting bugs, and Requesting Features\n\nWe provide a variety of channels for users and developers to get help, report\nbugs, requests features, or engage in community discussions. Below\nare a few of the most common we recommend using.\n\n* **GitHub Discussions**: A GitHub Discussions page. This can be used to start\ndiscussions or ask questions. Available at\n\u003chttps://github.com/orgs/gem5/discussions\u003e.\n* **GitHub Issues**: A GitHub Issues page for reporting bugs or requesting\nfeatures. Available at \u003chttps://github.com/gem5/gem5/issues\u003e.\n* **Jira Issue Tracker**: A Jira Issue Tracker for reporting bugs or requesting\nfeatures. Available at \u003chttps://gem5.atlassian.net/\u003e.\n* **Slack**: A Slack server with a variety of channels for the gem5 community\nto engage in a variety of discussions. Please visit\n\u003chttps://www.gem5.org/join-slack\u003e to join.\n* **gem5-users@gem5.org**: A mailing list for users of gem5 to ask questions\nor start discussions. To join the mailing list please visit\n\u003chttps://www.gem5.org/mailing_lists\u003e.\n* **gem5-dev@gem5.org**: A mailing list for developers of gem5 to ask questions\nor start discussions. To join the mailing list please visit\n\u003chttps://www.gem5.org/mailing_lists\u003e.\n\n## Contributing to gem5\n\nWe hope you enjoy using gem5. When appropriate we advise sharing your\ncontributions to the project. \u003chttps://www.gem5.org/contributing\u003e can help you\nget started. Additional information can be found in the CONTRIBUTING.md file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgem5%2Fgem5","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgem5%2Fgem5","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgem5%2Fgem5/lists"}