setup.py 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320
  1. # Copyright (c) Microsoft Corporation.
  2. # SPDX-License-Identifier: Apache-2.0
  3. # DeepSpeed Team
  4. """
  5. DeepSpeed library
  6. To build wheel on Windows:
  7. 1. Install pytorch, such as pytorch 1.12 + cuda 11.6.
  8. 2. Install visual cpp build tool.
  9. 3. Include cuda toolkit.
  10. 4. Launch cmd console with Administrator privilege for creating required symlink folders.
  11. Create a new wheel via the following command:
  12. build_win.bat
  13. The wheel will be located at: dist/*.whl
  14. """
  15. import os
  16. import sys
  17. import subprocess
  18. from setuptools import setup, find_packages
  19. import time
  20. import typing
  21. torch_available = True
  22. try:
  23. import torch
  24. except ImportError:
  25. torch_available = False
  26. print('[WARNING] Unable to import torch, pre-compiling ops will be disabled. ' \
  27. 'Please visit https://pytorch.org/ to see how to properly install torch on your system.')
  28. # We must avoid importing from deepspeed.* because that will execute the
  29. # __init__.py files. We insert the path here so we can still import from
  30. # op_builder and accelerator for precompiling.
  31. op_builder_path = os.path.join(os.path.dirname(__file__), "deepspeed/ops/")
  32. accelerator_path = os.path.join(os.path.dirname(__file__), "deepspeed/")
  33. sys.path.insert(0, op_builder_path)
  34. sys.path.insert(0, accelerator_path)
  35. from accelerator import get_accelerator
  36. from op_builder import get_default_compute_capabilities, OpBuilder
  37. from op_builder.all_ops import ALL_OPS
  38. from op_builder.builder import installed_cuda_version
  39. # Remove the added paths after importing
  40. sys.path.remove(op_builder_path)
  41. sys.path.remove(accelerator_path)
  42. # Fetch rocm state.
  43. is_rocm_pytorch = OpBuilder.is_rocm_pytorch()
  44. rocm_version = OpBuilder.installed_rocm_version()
  45. RED_START = '\033[31m'
  46. RED_END = '\033[0m'
  47. ERROR = f"{RED_START} [ERROR] {RED_END}"
  48. def abort(msg):
  49. print(f"{ERROR} {msg}")
  50. assert False, msg
  51. def fetch_requirements(path):
  52. with open(path, 'r') as fd:
  53. return [r.strip() for r in fd.readlines()]
  54. def is_env_set(key):
  55. """
  56. Checks if an environment variable is set and not "".
  57. """
  58. return bool(os.environ.get(key, None))
  59. def get_env_if_set(key, default: typing.Any = ""):
  60. """
  61. Returns an environment variable if it is set and not "",
  62. otherwise returns a default value. In contrast, the fallback
  63. parameter of os.environ.get() is skipped if the variable is set to "".
  64. """
  65. return os.environ.get(key, None) or default
  66. install_requires = fetch_requirements('requirements/requirements.txt')
  67. extras_require = {
  68. '1bit': [], # add cupy based on cuda/rocm version
  69. '1bit_mpi': fetch_requirements('requirements/requirements-1bit-mpi.txt'),
  70. 'readthedocs': fetch_requirements('requirements/requirements-readthedocs.txt'),
  71. 'dev': fetch_requirements('requirements/requirements-dev.txt'),
  72. 'autotuning': fetch_requirements('requirements/requirements-autotuning.txt'),
  73. 'autotuning_ml': fetch_requirements('requirements/requirements-autotuning-ml.txt'),
  74. 'sparse_attn': fetch_requirements('requirements/requirements-sparse_attn.txt'),
  75. 'sparse': fetch_requirements('requirements/requirements-sparse_pruning.txt'),
  76. 'inf': fetch_requirements('requirements/requirements-inf.txt'),
  77. 'sd': fetch_requirements('requirements/requirements-sd.txt'),
  78. 'triton': fetch_requirements('requirements/requirements-triton.txt'),
  79. }
  80. # Add specific cupy version to both onebit extension variants.
  81. if torch_available and torch.cuda.is_available():
  82. cupy = None
  83. if is_rocm_pytorch:
  84. rocm_major, rocm_minor = rocm_version
  85. # XXX cupy support for rocm 5 is not available yet.
  86. if rocm_major <= 4:
  87. cupy = f"cupy-rocm-{rocm_major}-{rocm_minor}"
  88. else:
  89. cuda_major_ver, cuda_minor_ver = installed_cuda_version()
  90. if (cuda_major_ver < 11) or ((cuda_major_ver == 11) and (cuda_minor_ver < 3)):
  91. cupy = f"cupy-cuda{cuda_major_ver}{cuda_minor_ver}"
  92. else:
  93. cupy = f"cupy-cuda{cuda_major_ver}x"
  94. if cupy:
  95. extras_require['1bit'].append(cupy)
  96. extras_require['1bit_mpi'].append(cupy)
  97. # Make an [all] extra that installs all needed dependencies.
  98. all_extras = set()
  99. for extra in extras_require.items():
  100. for req in extra[1]:
  101. all_extras.add(req)
  102. extras_require['all'] = list(all_extras)
  103. cmdclass = {}
  104. # For any pre-installed ops force disable ninja.
  105. if torch_available:
  106. cmdclass['build_ext'] = get_accelerator().build_extension().with_options(use_ninja=False)
  107. if torch_available:
  108. TORCH_MAJOR = torch.__version__.split('.')[0]
  109. TORCH_MINOR = torch.__version__.split('.')[1]
  110. else:
  111. TORCH_MAJOR = "0"
  112. TORCH_MINOR = "0"
  113. if torch_available and not torch.cuda.is_available():
  114. # Fix to allow docker builds, similar to https://github.com/NVIDIA/apex/issues/486.
  115. print("[WARNING] Torch did not find cuda available, if cross-compiling or running with cpu only "
  116. "you can ignore this message. Adding compute capability for Pascal, Volta, and Turing "
  117. "(compute capabilities 6.0, 6.1, 6.2)")
  118. if not is_env_set("TORCH_CUDA_ARCH_LIST"):
  119. os.environ["TORCH_CUDA_ARCH_LIST"] = get_default_compute_capabilities()
  120. ext_modules = []
  121. # Default to pre-install kernels to false so we rely on JIT on Linux, opposite on Windows.
  122. BUILD_OP_PLATFORM = 1 if sys.platform == "win32" else 0
  123. BUILD_OP_DEFAULT = int(get_env_if_set('DS_BUILD_OPS', BUILD_OP_PLATFORM))
  124. print(f"DS_BUILD_OPS={BUILD_OP_DEFAULT}")
  125. if BUILD_OP_DEFAULT:
  126. assert torch_available, "Unable to pre-compile ops without torch installed. Please install torch before attempting to pre-compile ops."
  127. def command_exists(cmd):
  128. if sys.platform == "win32":
  129. result = subprocess.Popen(f'{cmd}', stdout=subprocess.PIPE, shell=True)
  130. return result.wait() == 1
  131. else:
  132. result = subprocess.Popen(f'type {cmd}', stdout=subprocess.PIPE, shell=True)
  133. return result.wait() == 0
  134. def op_envvar(op_name):
  135. assert hasattr(ALL_OPS[op_name], 'BUILD_VAR'), \
  136. f"{op_name} is missing BUILD_VAR field"
  137. return ALL_OPS[op_name].BUILD_VAR
  138. def op_enabled(op_name):
  139. env_var = op_envvar(op_name)
  140. return int(get_env_if_set(env_var, BUILD_OP_DEFAULT))
  141. compatible_ops = dict.fromkeys(ALL_OPS.keys(), False)
  142. install_ops = dict.fromkeys(ALL_OPS.keys(), False)
  143. for op_name, builder in ALL_OPS.items():
  144. op_compatible = builder.is_compatible()
  145. compatible_ops[op_name] = op_compatible
  146. compatible_ops["deepspeed_not_implemented"] = False
  147. # If op is requested but not available, throw an error.
  148. if op_enabled(op_name) and not op_compatible:
  149. env_var = op_envvar(op_name)
  150. if not is_env_set(env_var):
  151. builder.warning(f"One can disable {op_name} with {env_var}=0")
  152. abort(f"Unable to pre-compile {op_name}")
  153. # If op is compatible but install is not enabled (JIT mode).
  154. if is_rocm_pytorch and op_compatible and not op_enabled(op_name):
  155. builder.hipify_extension()
  156. # If op install enabled, add builder to extensions.
  157. if op_enabled(op_name) and op_compatible:
  158. assert torch_available, f"Unable to pre-compile {op_name}, please first install torch"
  159. install_ops[op_name] = op_enabled(op_name)
  160. ext_modules.append(builder.builder())
  161. print(f'Install Ops={install_ops}')
  162. # Write out version/git info.
  163. git_hash_cmd = "git rev-parse --short HEAD"
  164. git_branch_cmd = "git rev-parse --abbrev-ref HEAD"
  165. if command_exists('git') and not is_env_set('DS_BUILD_STRING'):
  166. try:
  167. result = subprocess.check_output(git_hash_cmd, shell=True)
  168. git_hash = result.decode('utf-8').strip()
  169. result = subprocess.check_output(git_branch_cmd, shell=True)
  170. git_branch = result.decode('utf-8').strip()
  171. except subprocess.CalledProcessError:
  172. git_hash = "unknown"
  173. git_branch = "unknown"
  174. else:
  175. git_hash = "unknown"
  176. git_branch = "unknown"
  177. # Parse the DeepSpeed version string from version.txt.
  178. version_str = open('version.txt', 'r').read().strip()
  179. # Build specifiers like .devX can be added at install time. Otherwise, add the git hash.
  180. # Example: DS_BUILD_STRING=".dev20201022" python setup.py sdist bdist_wheel.
  181. # Building wheel for distribution, update version file.
  182. if is_env_set('DS_BUILD_STRING'):
  183. # Build string env specified, probably building for distribution.
  184. with open('build.txt', 'w') as fd:
  185. fd.write(os.environ['DS_BUILD_STRING'])
  186. version_str += os.environ['DS_BUILD_STRING']
  187. elif os.path.isfile('build.txt'):
  188. # build.txt exists, probably installing from distribution.
  189. with open('build.txt', 'r') as fd:
  190. version_str += fd.read().strip()
  191. else:
  192. # None of the above, probably installing from source.
  193. version_str += f'+{git_hash}'
  194. torch_version = ".".join([TORCH_MAJOR, TORCH_MINOR])
  195. bf16_support = False
  196. # Set cuda_version to 0.0 if cpu-only.
  197. cuda_version = "0.0"
  198. nccl_version = "0.0"
  199. # Set hip_version to 0.0 if cpu-only.
  200. hip_version = "0.0"
  201. if torch_available and torch.version.cuda is not None:
  202. cuda_version = ".".join(torch.version.cuda.split('.')[:2])
  203. if sys.platform != "win32":
  204. if isinstance(torch.cuda.nccl.version(), int):
  205. # This will break if minor version > 9.
  206. nccl_version = ".".join(str(torch.cuda.nccl.version())[:2])
  207. else:
  208. nccl_version = ".".join(map(str, torch.cuda.nccl.version()[:2]))
  209. if hasattr(torch.cuda, 'is_bf16_supported') and torch.cuda.is_available():
  210. bf16_support = torch.cuda.is_bf16_supported()
  211. if torch_available and hasattr(torch.version, 'hip') and torch.version.hip is not None:
  212. hip_version = ".".join(torch.version.hip.split('.')[:2])
  213. torch_info = {
  214. "version": torch_version,
  215. "bf16_support": bf16_support,
  216. "cuda_version": cuda_version,
  217. "nccl_version": nccl_version,
  218. "hip_version": hip_version
  219. }
  220. print(f"version={version_str}, git_hash={git_hash}, git_branch={git_branch}")
  221. with open('deepspeed/git_version_info_installed.py', 'w') as fd:
  222. fd.write(f"version='{version_str}'\n")
  223. fd.write(f"git_hash='{git_hash}'\n")
  224. fd.write(f"git_branch='{git_branch}'\n")
  225. fd.write(f"installed_ops={install_ops}\n")
  226. fd.write(f"compatible_ops={compatible_ops}\n")
  227. fd.write(f"torch_info={torch_info}\n")
  228. print(f'install_requires={install_requires}')
  229. print(f'compatible_ops={compatible_ops}')
  230. print(f'ext_modules={ext_modules}')
  231. # Parse README.md to make long_description for PyPI page.
  232. thisdir = os.path.abspath(os.path.dirname(__file__))
  233. with open(os.path.join(thisdir, 'README.md'), encoding='utf-8') as fin:
  234. readme_text = fin.read()
  235. start_time = time.time()
  236. setup(name='deepspeed',
  237. version=version_str,
  238. description='DeepSpeed library',
  239. long_description=readme_text,
  240. long_description_content_type='text/markdown',
  241. author='DeepSpeed Team',
  242. author_email='deepspeed-info@microsoft.com',
  243. url='http://deepspeed.ai',
  244. project_urls={
  245. 'Documentation': 'https://deepspeed.readthedocs.io',
  246. 'Source': 'https://github.com/microsoft/DeepSpeed',
  247. },
  248. install_requires=install_requires,
  249. extras_require=extras_require,
  250. packages=find_packages(include=['deepspeed', 'deepspeed.*']),
  251. include_package_data=True,
  252. scripts=[
  253. 'bin/deepspeed', 'bin/deepspeed.pt', 'bin/ds', 'bin/ds_ssh', 'bin/ds_report', 'bin/ds_bench', 'bin/dsr',
  254. 'bin/ds_elastic'
  255. ],
  256. classifiers=[
  257. 'Programming Language :: Python :: 3.6', 'Programming Language :: Python :: 3.7',
  258. 'Programming Language :: Python :: 3.8', 'Programming Language :: Python :: 3.9',
  259. 'Programming Language :: Python :: 3.10'
  260. ],
  261. license='Apache Software License 2.0',
  262. ext_modules=ext_modules,
  263. cmdclass=cmdclass)
  264. end_time = time.time()
  265. print(f'deepspeed build time = {end_time - start_time} secs')