{"id":20229263,"url":"https://github.com/rahulunair/xpu_setup","last_synced_at":"2025-04-10T17:50:51.506Z","repository":{"id":154826330,"uuid":"630145531","full_name":"rahulunair/xpu_setup","owner":"rahulunair","description":"Setup Ubuntu 22.04 with Intel dGPUs and components from Intel OneAPI","archived":false,"fork":false,"pushed_at":"2024-01-10T00:20:43.000Z","size":196,"stargazers_count":6,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-01-10T03:29:58.175Z","etag":null,"topics":["dgpu","intel-gpu"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rahulunair.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"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}},"created_at":"2023-04-19T19:04:55.000Z","updated_at":"2024-01-10T03:30:00.785Z","dependencies_parsed_at":null,"dependency_job_id":"c7004440-2fda-4777-8cdd-1136f955ce9b","html_url":"https://github.com/rahulunair/xpu_setup","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahulunair%2Fxpu_setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahulunair%2Fxpu_setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahulunair%2Fxpu_setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rahulunair%2Fxpu_setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rahulunair","download_url":"https://codeload.github.com/rahulunair/xpu_setup/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224586267,"owners_count":17335947,"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":["dgpu","intel-gpu"],"created_at":"2024-11-14T07:35:04.863Z","updated_at":"2024-11-14T07:35:05.364Z","avatar_url":"https://github.com/rahulunair.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Unofficial Setup Guide for Intel discrete GPU on Linux*\n\nThis guide provides step-by-step instructions for setting up an Intel discrete GPUs on Ubuntu 22.04. The repository contains a series of scripts that automate the configuration process, making it easier and more efficient. Depending on your specific dGPU, you can use one of the following branches:\n\n    - For Intel Data Center GPU Max Series (PVC) setup, use the 'main' branch (default).\n    - For Intel Arc (Alchemist) GPUs setup, use the 'arc' branch.\n    - For Intel Data Center GPU Flex Series (ATS) setup, use the 'flex' branch.\n    \nSelect one from (default is 'main' for GPU Max):\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/786476/234941539-fa4d3a30-5e5d-4888-990e-8cf13766abe5.png\" width=\"300\" alt=\"Branches Screenshot\"\u003e\n\u003c/p\u003e\n\n\n\n### Prerequisites\n\nMake sure to setup the base operating system on your machine using a variant of Ubuntu 22.04 (Jammy). For servers, download the [Ubuntu 22.04 cloud image](https://cloud-images.ubuntu.com/jammy/current/) (jammy). Additionally, ensure that your machine is connected to the internet before proceeding.\n\n### xpu\\_setup Repository Structure\n\nThe essential components for setting up a GPU device in the repo has the following structure:\n\n| File Name                  | Description                                      |\n|---------------------------|--------------------------------------------------|\n├── LICENSE\n├── Readme.md\n├── base\n│   ├── [01_init_setup.sh](https://github.com/rahulunair/xpu_setup/blob/main/basinit_setup.sh)           | Initialize the server     |\n│   ├── [02_kernel_setup.sh](https://github.com/rahulunair/xpu_setup/blob/main/base/2_kernel_setup.sh)         | Install and setup the required kernel version    |\n│   ├── [03_gpu_drivers_setup.sh](https://github.com/rahulunair/xpu_setup/blob/main/base/3_gpu_drivers_setup.sh)    | Install  the Intel GPU drivers, runtimes      |\n│   ├── [04_hold-packages.sh](https://github.com/rahulunair/xpu_setup/blob/main/base/4_hold-packages.sh)        | Prevent package updates from breaking compatibility |\n│   ├── [05_env_dev_utils_setup.sh](https://github.com/rahulunair/xpu_setup/blob/main/base/5_env_dev_utils_setup.sh)  | Setup the reqd tools \u0026 env (use '--no-docker' flag to not install docker)|\n│   ├── [06_conda_setup.sh](https://github.com/rahulunair/xpu_setup/blob/main/base/6_conda_setup.sh)          | Install and configure the Conda package manager  |\n│   ├── [07_basekit_setup.sh](https://github.com/rahulunair/xpu_setup/blob/main/base/7_basekit_setup.sh)        | Install the required development toolkits        |\n│   ├── [08_motd_setup.sh](https://github.com/rahulunair/xpu_setup/blob/main/base/8_motd_setup.sh)           | Customize the server login message               |\n│   ├── [09_cleanup.sh](https://github.com/rahulunair/xpu_setup/blob/main/base/9_cleanup.sh)              | Clean up any unnecessary packages and files      |\n│   └── Readme.md\n├── test.md\n└── utils\n    └── update_kernel.py\n\n\n### How to setup and configure the base image.\n\nTo follow along and setup a server with intel descrete GPUs and base configuration:\n\nClone the repository:\n\n```bash\ngit clone https://github/rahulunair/xpu_setup\n```\nOptional step:\n\nSwitch branch to 'arc' or 'flex' if you are setting up either Intel Arc GPUs or Intel Data Center GPU Flex Series.\n\n```bash\ngit checkout arc # for Intel Arc GPUs\n```\nChange directory to base inside xpu\\_setup and follow the Readme.md inside 'base':\n\n```bash\ncd xpu_verify/base\n```\n\nAfter the setup is complete, you can verify if the GPU is setup correctly using the tool [xpu\\_verify](https://github.com/rahulunair/xpu_verify).Additionally, you can use clinfo and hwinfo to confirm that the GPU can be successfully enumerated.\n\n### Conclusion\n\nThe provided documentation covers each step in detail, ensuring a smooth setup process. If you encounter any issues during the setup or have any questions, please do not hesitate to raise an issue on the GitHub repository. This will help us improve the documentation and address any potential problems promptly.\n\n\\* I have tried to be as faithful as I can to the [official guide](https://dgpu-docs.intel.com/installation-guides/index.html), but added some additional bits to make life easier.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahulunair%2Fxpu_setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frahulunair%2Fxpu_setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frahulunair%2Fxpu_setup/lists"}