Install HTTPX using pip:
```shell
-pip install httpx
+$ pip install httpx
```
Now, let's get started:
Or, using the command-line client.
```shell
-pip install 'httpx[cli]' # The command line client is an optional dependency.
+$ pip install 'httpx[cli]' # The command line client is an optional dependency.
```
Which now allows us to use HTTPX directly from the command-line...
Install with pip:
```shell
-pip install httpx
+$ pip install httpx
```
Or, to include the optional HTTP/2 support, use:
```shell
-pip install httpx[http2]
+$ pip install httpx[http2]
```
HTTPX requires Python 3.8+.
You can install SOCKS support using `pip`:
```shell
-pip install httpx[socks]
+$ pip install httpx[socks]
```
You can now configure a client to make requests via a proxy using the SOCKS protocol:
your GitHub username:
```shell
-git clone https://github.com/YOUR-USERNAME/httpx
+$ git clone https://github.com/YOUR-USERNAME/httpx
```
You can now install the project and its dependencies using:
```shell
-cd httpx
-scripts/install
+$ cd httpx
+$ scripts/install
```
## Testing and Linting
To run the tests, use:
```shell
-scripts/test
+$ scripts/test
```
!!! warning
For example, to run a single test script:
```shell
-scripts/test tests/test_multipart.py
+$ scripts/test tests/test_multipart.py
```
To run the code auto-formatting:
```shell
-scripts/lint
+$ scripts/lint
```
Lastly, to run code checks separately (they are also run as part of `scripts/test`), run:
```shell
-scripts/check
+$ scripts/check
```
## Documenting
To run the documentation site locally (useful for previewing changes), use:
```shell
-scripts/docs
+$ scripts/docs
```
## Resolving Build / CI Failures
You can look at the job output to figure out why it's failed or within a shell run:
```shell
-scripts/check
+$ scripts/check
```
It may be worth it to run `$ scripts/lint` to attempt auto-formatting the code
the optional HTTP/2 dependencies...
```shell
-pip install httpx[http2]
+$ pip install httpx[http2]
```
And then instantiating a client with HTTP/2 support enabled:
Install HTTPX using pip:
```shell
-pip install httpx
+$ pip install httpx
```
Now, let's get started:
```shell
# The command line client is an optional dependency.
-pip install 'httpx[cli]'
+$ pip install 'httpx[cli]'
```
Which now allows us to use HTTPX directly from the command-line...
Install with pip:
```shell
-pip install httpx
+$ pip install httpx
```
Or, to include the optional HTTP/2 support, use:
```shell
-pip install httpx[http2]
+$ pip install httpx[http2]
```
To include the optional brotli and zstandard decoders support, use:
```shell
-pip install httpx[brotli,zstd]
+$ pip install httpx[brotli,zstd]
```
HTTPX requires Python 3.8+