{"id":46083870,"url":"https://github.com/tensorturtle/metacycle","last_synced_at":"2026-03-01T16:16:58.425Z","repository":{"id":275276646,"uuid":"925620066","full_name":"tensorturtle/metacycle","owner":"tensorturtle","description":"Open source, open world cycling simulator with extreme realism","archived":false,"fork":false,"pushed_at":"2025-11-09T06:35:49.000Z","size":305,"stargazers_count":4,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-09T08:25:38.313Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tensorturtle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-01T10:15:38.000Z","updated_at":"2025-11-09T06:35:52.000Z","dependencies_parsed_at":"2025-02-01T11:22:44.120Z","dependency_job_id":"b6dcb669-c059-45a6-919c-7589107a0ebc","html_url":"https://github.com/tensorturtle/metacycle","commit_stats":null,"previous_names":["tensorturtle/metacycle"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tensorturtle/metacycle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tensorturtle%2Fmetacycle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tensorturtle%2Fmetacycle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tensorturtle%2Fmetacycle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tensorturtle%2Fmetacycle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tensorturtle","download_url":"https://codeload.github.com/tensorturtle/metacycle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tensorturtle%2Fmetacycle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29974694,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T15:41:30.362Z","status":"ssl_error","status_checked_at":"2026-03-01T15:37:07.343Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-03-01T16:16:57.859Z","updated_at":"2026-03-01T16:16:58.412Z","avatar_url":"https://github.com/tensorturtle.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# metacycle\n\n**Metacycle** is an open source cycling simulator. It pairs with smart indoor cycling accessories to offer the highest degree of in-game control and feedback.\n\n`metacycle` is to **Zwift** as **Project Cars** is to **Mario Kart**.\n\nIn other words, it's a serious simulator, not an arcade game. Metacycle has lifelike physics, sophisticated graphics, and deeply modifiable maps and environment.\n\n\n## Requirements\n\n1. Your Bike\n2. Smart steering plate\n3. Smart Trainer\n4. Gaming computer running Windows 10+ or Ubuntu 22.04+\n\nCurrently, the only smart steering plate on the market is [Elite Sterzo](https://www.elite-it.com/en/products/home-trainers/ecosystem-accessories/sterzo-smart). Any smart trainer supporting Bluetooth FTMS by Elite, JetBlack, Wahoo, Tacx, etc. are compatible.\n\n*No affiliation with any manufacturers.*\n\n## Quickstart\n\n### 1. Install Carla\n\nDownload [Carla Simulator 0.9.15](https://github.com/carla-simulator/carla/releases/tag/0.9.15/) from the Github Release.\n\n#### Windows\n\nOpen the downloaded ZIP file. Uncompress it to a location of your choice and find `CarlaUE4.exe`. Double click to launch it.\n\n#### Linux (Ubuntu)\n\nUn-tar it:\n```\ntar -xvf CARLA_0.9.15.tar.gz\n```\n\nRun the launch script:\n```\n./CarlaUE4.sh\n```\n\n### 2. Install Metacycle\n\nInstall UV, a python package manager (instructions [here](https://docs.astral.sh/uv/getting-started/installation/))\n\nThen, download the required python version and metacycle app. From the terminal or powershell:\n```\nuv python install 3.10\nuv tool install metacycle --python 3.10\n```\nThis will install `metacycle` to your system, so that it can be launched directly.\n\nLaunch metacycle\n```\nmetacycle\n```\n\nYou can pass in a `--map ` argument from available CARLA maps. For example:\n```\nmetacycle --map Town10HD\n```\nA list and description of the maps are available from [CARLA docs](https://carla.readthedocs.io/en/latest/core_map/#carla-maps)\n\n\n## Read More\n\n+ [STORY.md](STORY.md) - The history of this project.\n+ [CONTRIBUTING.md](CONTRIBUTING.md) - For developers who want to contribute to this project.\n\n## FAQ\n\n### How do I upgrade to the latest version?\n\nSometimes, the cache needs to be cleared in order to get the latest version.\n```\nuv cache clean\n```\n\nThe following command will find and install the latest published version.\n```\nuv tool upgrade metacycle\n```\n\nCARLA must be re-installed manually. Please refer to [CARLA docs](https://carla.readthedocs.io/en/latest/start_quickstart/#updating-carla)\n\n### How do I remove/uninstall the program?\n\n```\nuv tool uninstall metacycle\n```\n\nCARLA must be uninstall manually by deleting the program yourself.\n\n### What is BLE? How do I know if my cycling accessories or computer support it?\n\nMost modern 'smart' cycling accessories communicate using Bluetooth Low Energy. It is sometimes abbreviated to 'BLE'. Bluetooth 4 may or may not support 'Low Energy', so check with the computer manufacturer. Bluetooth 5 and 6 always includes support for 'Low Energy'. Most cycling accessories are not compatible with older, non-'Low Energy' versions of Bluetooth.\n\n### My cycling accessories (such as powermeter) support ANT+ but not Bluetooth. Can I use it with metacycle?\n\nNo, ANT+ is a completely different protocol that is not supported for this project.\n\n### Why do I need a high-performance gaming computer to run metacycle?\n\nMetacycle is based Unreal Engine 4, a serious 3D game engine with full customizability, so it'll be more demanding than typical indoor cycling games.\n\n+ CPU: Intel Core i5 6th-gen or better.\n+ GPU: NVIDIA RTX 2070 or better (2080, 3060, 3070, 3080, 4060, 4070, 4080 etc.)\n+ Hard drive: 30GB of free space.\n+ Bluetooth Low Energy (BLE) support.\n+ Internet connection required for installation, not required to run the game.\n\nThere is work being done upstream (in Carla) to upgrade to Unreal Engine 5, which will have potentially higher system requirements (16GB+ VRAM)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftensorturtle%2Fmetacycle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftensorturtle%2Fmetacycle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftensorturtle%2Fmetacycle/lists"}