# @openally/httpie
> Node.js HTTP client that use Undici client
Latest version **2.0.0** (published 2026-08-28) · MIT license · 0 weekly downloads
## Install
```sh
npm install @openally/httpie
pnpm add @openally/httpie
yarn add @openally/httpie
bun add @openally/httpie
```
## Health
**Score 75/100 (B)** — status: active.
Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.
Warnings: low downloads.
## Facts
| | |
|---|---|
| Version | 2.0.0 |
| Published | 2026-08-28 |
| First published | 2025-08-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22 |
| Dependencies | 2 |
| Unpacked size | 79.8 KB |
| Known vulnerabilities | 0 (+11 in 1 direct dependencies) |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| Author | GENTILHOMME Thomas |
| Maintainers | fraxken, pierred |
## Links
- npm: https://www.npmjs.com/package/@openally/httpie
- Repository: https://github.com/OpenAlly/httpie
- Homepage: https://github.com/OpenAlly/httpie#readme
- Issues: https://github.com/OpenAlly/httpie/issues
- npm.io page: https://npm.io/package/@openally/httpie
## Dependencies (2)
- [undici](https://npm.io/package/undici.md) 8.10.0
- [@openally/result](https://npm.io/package/@openally/result.md) 3.1.0
## Recent versions
- 2.0.0 (latest) — 2026-08-28
- 1.1.4 — 2026-08-12
- 1.1.3 — 2026-07-08
- 1.1.2 — 2026-03-19
- 1.1.1 — 2026-03-19
- 1.1.0 — 2026-03-09
- 1.0.0 — 2025-08-25
## README
Httpie
A modern and light Node.js http client 🐢🚀.
## 📢 About
The package is inspired by lukeed [httpie](https://github.com/lukeed/httpie) (The use is relatively similar). This package use new Node.js http client [undici](https://github.com/nodejs/undici) under the hood.
## 🔬 Features
- Automatically parse based on the `content-type`.
- Automatically decompress based on the `content-encoding`.
- Includes aliases for common HTTP verbs: `get`, `post`, `put`, `patch`, and `del`.
- Able to automatically detect domains and paths to assign the right Agent (use a LRU cache to avoid repetitive computation).
- Allows to use an accurate rate-limiter like `p-ratelimit` with the `limit` option.
- Safe error handling with Rust-like [Result](https://github.com/OpenAlly/npm-packages/tree/main/src/result).
Thanks to undici:
- Support [redirections](https://developer.mozilla.org/en-US/docs/Web/HTTP/Redirections) or retry using interceptors.
- Implement high-level API for undici **stream** and **pipeline** method.
- High performance (see [benchmarks](https://undici.nodejs.org/#/?id=benchmarks)).
- Work well with **newest** Node.js API [AbortController](https://nodejs.org/dist/latest-v16.x/docs/api/globals.html#globals_class_abortcontroller) to cancel http request.
Light with seriously maintained dependencies:
## 🚧 Requirements
- [Node.js](https://nodejs.org/en/) version 22 or higher
## 🚀 Getting Started
This package is available in the Node Package Repository and can be easily installed with [npm](https://docs.npmjs.com/getting-started/what-is-npm) or [yarn](https://yarnpkg.com).
```bash
$ npm i @openally/httpie
# or
$ yarn add @openally/httpie
```
## 📚 Usage example
This client is very similar to lukeed httpie http client.
```js
import * as httpie from "@openally/httpie";
try {
const { data } = await httpie.get("https://jsonplaceholder.typicode.com/posts");
console.log(data);
const response = await httpie.post("https://jsonplaceholder.typicode.com/posts", {
body: {
title: "foo",
body: "bar",
userId: 1
}
});
console.log(response.statusCode);
console.log(response.statusMessage);
console.log(response.data);
}
catch (error) {
console.log(error.message);
console.log(error.statusCode);
console.log(error.headers);
console.log(error.data);
}
```
You can also use the `safe` prefix API to get a `Promise>`
```ts
import * as httpie from "@openally/httpie";
const response = (await httpie.safePost("https://jsonplaceholder.typicode.com/posts", {
body: {
title: "foo",
body: "bar",
userId: 1
}
}))
.map((response) => response.data)
.mapErr((error) => new Error("a message here!", { cause: error.data }));
.unwrap();
```
> [!TIP]
> More examples available in the root folder **examples**.
## 📜 API
- [Request API](./docs/request.md)
- [Work and manage Agents](./docs/agents.md)
## Error handling
Read the [error documentation](./docs/errors.md).
## Contributors ✨
[](#contributors-)
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
## License
MIT
---
_Source: https://npm.io/package/@openally/httpie · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
