You can complete the three steps below to install Cogent Core on your system. You can also explore the demo, basics, tutorials, and widgets. You can also see how to build apps.
1. Download and install Go from the Go website if you do not already have Go 1.22.6+ installed.
2. Run the following command to install the Cogent Core command line tool. You should run this command again each time you update to a new version of Cogent Core.
- 1. After reading the info for your platform below, run the following command to install platform-specific dependencies. You must restart your shell/prompt/terminal after running the command.
macOS
This installs the xcode-tools. You may need to follow installer prompts. You must have Go 1.22.6+ installed due to an Xcode issue.
Windows
This installs w64devkit and Git. You must run the setup command from a shell/prompt/terminal (such as Command Prompt or Git Bash) explicitly “Run as administrator”. You may need to follow steps in installers; the default options are good. After running this command, you must run all future commands related to Cogent Core in Git Bash.
Linux
This installs Go, gcc, and various graphics libraries. You may need to enter your password so that it can run sudo commands.
If you want to install manually instead, the commands for each distro are listed below.
Demo
You can run the Cogent Core Demo to verify Cogent Core is properly installed on your system:
You can also see the web version of the demo.
Troubleshooting
If you run into any issues while installing Cogent Core or trying to run the demo, please re-read all of the install instructions above and make sure that you have followed them.
If the problem still happens, it is probably related to WebGPU and/or Vulkan. If you are on Linux, please follow these instructions (or other ones for your distro) to make sure you have your device-specific Vulkan drivers installed.
If you still have problems, please file an issue. Please include the output of webgpuinfo in your bug report. If you are on Linux, please also include the output of vulkaninfo.
After the demo is working, you can explore the basics, tutorials, and widgets. You can also see how to build apps.