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.
metacycle is to Zwift as Project Cars is to Mario Kart.
In other words, it's a serious simulator, not an arcade game. Metacycle has lifelike physics, sophisticated graphics, and deeply modifiable maps and environment.
- Your Bike
- Smart steering plate
- Smart Trainer
- Gaming computer running Windows 10+ or Ubuntu 22.04+
Currently, the only smart steering plate on the market is Elite Sterzo. Any smart trainer supporting Bluetooth FTMS by Elite, JetBlack, Wahoo, Tacx, etc. are compatible.
No affiliation with any manufacturers.
Download Carla Simulator 0.9.15 from the Github Release.
Open the downloaded ZIP file. Uncompress it to a location of your choice and find CarlaUE4.exe. Double click to launch it.
Un-tar it:
tar -xvf CARLA_0.9.15.tar.gz
Run the launch script:
./CarlaUE4.sh
Install UV, a python package manager (instructions here)
Then, download the required python version and metacycle app. From the terminal or powershell:
uv python install 3.10
uv tool install metacycle --python 3.10
This will install metacycle to your system, so that it can be launched directly.
Launch metacycle
metacycle
You can pass in a --map argument from available CARLA maps. For example:
metacycle --map Town10HD
A list and description of the maps are available from CARLA docs
- STORY.md - The history of this project.
- CONTRIBUTING.md - For developers who want to contribute to this project.
Sometimes, the cache needs to be cleared in order to get the latest version.
uv cache clean
The following command will find and install the latest published version.
uv tool upgrade metacycle
CARLA must be re-installed manually. Please refer to CARLA docs
uv tool uninstall metacycle
CARLA must be uninstall manually by deleting the program yourself.
Most 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.
My cycling accessories (such as powermeter) support ANT+ but not Bluetooth. Can I use it with metacycle?
No, ANT+ is a completely different protocol that is not supported for this project.
Metacycle is based Unreal Engine 4, a serious 3D game engine with full customizability, so it'll be more demanding than typical indoor cycling games.
- CPU: Intel Core i5 6th-gen or better.
- GPU: NVIDIA RTX 2070 or better (2080, 3060, 3070, 3080, 4060, 4070, 4080 etc.)
- Hard drive: 30GB of free space.
- Bluetooth Low Energy (BLE) support.
- Internet connection required for installation, not required to run the game.
There is work being done upstream (in Carla) to upgrade to Unreal Engine 5, which will have potentially higher system requirements (16GB+ VRAM)