]>
Commit | Line | Data |
---|---|---|
1d09f67e TL |
1 | .. Licensed to the Apache Software Foundation (ASF) under one |
2 | .. or more contributor license agreements. See the NOTICE file | |
3 | .. distributed with this work for additional information | |
4 | .. regarding copyright ownership. The ASF licenses this file | |
5 | .. to you under the Apache License, Version 2.0 (the | |
6 | .. "License"); you may not use this file except in compliance | |
7 | .. with the License. You may obtain a copy of the License at | |
8 | ||
9 | .. http://www.apache.org/licenses/LICENSE-2.0 | |
10 | ||
11 | .. Unless required by applicable law or agreed to in writing, | |
12 | .. software distributed under the License is distributed on an | |
13 | .. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | |
14 | .. KIND, either express or implied. See the License for the | |
15 | .. specific language governing permissions and limitations | |
16 | .. under the License. | |
17 | ||
18 | Installing PyArrow | |
19 | ================== | |
20 | ||
21 | System Compatibility | |
22 | -------------------- | |
23 | ||
24 | PyArrow is regularly built and tested on Windows, macOS and various Linux | |
25 | distributions (including Ubuntu 16.04, Ubuntu 18.04). We strongly recommend | |
26 | using a 64-bit system. | |
27 | ||
28 | Python Compatibility | |
29 | -------------------- | |
30 | ||
31 | PyArrow is currently compatible with Python 3.6, 3.7, 3.8, and 3.9. | |
32 | ||
33 | Using Conda | |
34 | ----------- | |
35 | ||
36 | Install the latest version of PyArrow from | |
37 | `conda-forge <https://conda-forge.org/>`_ using `Conda <https://conda.io>`_: | |
38 | ||
39 | .. code-block:: bash | |
40 | ||
41 | conda install -c conda-forge pyarrow | |
42 | ||
43 | Using Pip | |
44 | --------- | |
45 | ||
46 | Install the latest version from `PyPI <https://pypi.org/>`_ (Windows, Linux, | |
47 | and macOS): | |
48 | ||
49 | .. code-block:: bash | |
50 | ||
51 | pip install pyarrow | |
52 | ||
53 | If you encounter any importing issues of the pip wheels on Windows, you may | |
54 | need to install the `Visual C++ Redistributable for Visual Studio 2015 | |
55 | <https://www.microsoft.com/en-us/download/details.aspx?id=48145>`_. | |
56 | ||
57 | .. warning:: | |
58 | On Linux, you will need pip >= 19.0 to detect the prebuilt binary packages. | |
59 | ||
60 | Installing from source | |
61 | ---------------------- | |
62 | ||
63 | See :ref:`python-development`. | |
64 | ||
65 | Installing Nightly Packages | |
66 | --------------------------- | |
67 | ||
68 | .. warning:: | |
69 | These packages are not official releases. Use them at your own risk. | |
70 | ||
71 | PyArrow has nightly wheels and conda packages for testing purposes. | |
72 | ||
73 | These may be suitable for downstream libraries in their continuous integration | |
74 | setup to maintain compatibility with the upcoming PyArrow features, | |
75 | deprecations and/or feature removals. | |
76 | ||
77 | Install the development version of PyArrow from `arrow-nightlies | |
78 | <https://anaconda.org/arrow-nightlies/pyarrow>`_ conda channel: | |
79 | ||
80 | .. code-block:: bash | |
81 | ||
82 | conda install -c arrow-nightlies pyarrow | |
83 | ||
84 | Install the development version from an `alternative PyPI | |
85 | <https://gemfury.com/arrow-nightlies>`_ index: | |
86 | ||
87 | .. code-block:: bash | |
88 | ||
89 | pip install --extra-index-url https://pypi.fury.io/arrow-nightlies/ \ | |
90 | --prefer-binary --pre pyarrow |