| 
									
										
										
										
											2015-10-18 18:45:32 -07:00
										 |  |  |  | 
					
						
							|  |  |  | ============ | 
					
						
							| 
									
										
										
										
											2014-01-13 05:10:08 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  | Spack is a package management tool designed to support multiple | 
					
						
							|  |  |  | versions and configurations of software on a wide variety of platforms | 
					
						
							|  |  |  | and environments. It was designed for large supercomputing centers, | 
					
						
							|  |  |  | where many users and application teams share common installations of | 
					
						
							|  |  |  | software on clusters with exotic architectures, using libraries that | 
					
						
							|  |  |  | do not have a standard ABI. Spack is non-destructive: installing a new | 
					
						
							|  |  |  | version does not break existing installations, so many configurations | 
					
						
							|  |  |  | can coexist on the same system. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Most importantly, Spack is simple. It offers a simple spec syntax so | 
					
						
							|  |  |  | that users can specify versions and configuration options | 
					
						
							|  |  |  | concisely. Spack is also simple for package authors: package files are | 
					
						
							| 
									
										
										
										
											2015-10-16 06:33:03 -04:00
										 |  |  | written in pure Python, and specs allow package authors to write a | 
					
						
							| 
									
										
										
										
											2014-01-13 05:10:08 +01:00
										 |  |  | single build script for many different builds of the same package. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | See the | 
					
						
							|  |  |  | [Feature Overview](http://scalability-llnl.github.io/spack/features.html) | 
					
						
							|  |  |  | for examples and highlights. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | To install spack and install your first package: | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2014-09-19 09:54:39 -07:00
										 |  |  |     $ git clone https://github.com/scalability-llnl/spack.git | 
					
						
							| 
									
										
										
										
											2014-01-13 05:10:08 +01:00
										 |  |  |     $ cd spack/bin | 
					
						
							|  |  |  |     $ ./spack install libelf | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Documentation | 
					
						
							|  |  |  | ---------------- | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | [Full documentation](http://scalability-llnl.github.io/spack) | 
					
						
							|  |  |  | for Spack is also available. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2015-03-24 09:58:32 -07:00
										 |  |  | Get Involved! | 
					
						
							| 
									
										
										
										
											2015-03-24 09:28:47 -07:00
										 |  |  | ------------------------ | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2015-03-24 09:58:32 -07:00
										 |  |  | Spack is an open source project.  Questions, discussion, and | 
					
						
							|  |  |  | contributions are welcome. Contributions can be anything from new | 
					
						
							|  |  |  | packages to bugfixes, or even new core features. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ### Mailing list
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | If you are interested in contributing to spack, the first step is to | 
					
						
							| 
									
										
										
										
											2015-04-13 11:02:13 -07:00
										 |  |  | join the mailing list.  We're using a Google Group for this, and you | 
					
						
							|  |  |  | can join it here: | 
					
						
							| 
									
										
										
										
											2015-03-24 09:28:47 -07:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2015-04-13 11:02:13 -07:00
										 |  |  |   * [Spack Google Group](https://groups.google.com/d/forum/spack) | 
					
						
							| 
									
										
										
										
											2015-03-24 09:28:47 -07:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2015-03-24 09:58:32 -07:00
										 |  |  | ### Contributions
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | At the moment, contributing to Spack is relatively simple.  Just send us | 
					
						
							|  |  |  | a [pull request](https://help.github.com/articles/using-pull-requests/). | 
					
						
							|  |  |  | When you send your request, make ``develop`` the destination branch. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Spack is using a rough approximation of the [Git | 
					
						
							|  |  |  | Flow](http://nvie.com/posts/a-successful-git-branching-model/) | 
					
						
							|  |  |  | branching model.  The ``develop`` branch contains the latest | 
					
						
							|  |  |  | contributions, and ``master`` is always tagged and points to the | 
					
						
							|  |  |  | latest stable release. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2014-01-13 05:10:08 +01:00
										 |  |  | Authors | 
					
						
							|  |  |  | ---------------- | 
					
						
							| 
									
										
										
										
											2015-10-17 17:41:17 -07:00
										 |  |  | Many thanks go to Spack's [contributors](https://github.com/scalability-llnl/spack/graphs/contributors). | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Spack was originally written by Todd Gamblin, tgamblin@llnl.gov. | 
					
						
							| 
									
										
										
										
											2014-08-01 08:33:00 -07:00
										 |  |  | 
 | 
					
						
							|  |  |  | Release | 
					
						
							|  |  |  | ---------------- | 
					
						
							|  |  |  | Spack is released under an LGPL license.  For more details see the | 
					
						
							|  |  |  | LICENSE file. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ``LLNL-CODE-647188`` |