# @helia/http
[](https://ipfs.tech)
[](https://discuss.ipfs.tech)
[](https://codecov.io/gh/ipfs/helia)
[](https://github.com/ipfs/helia/actions/workflows/main.yml?query=branch%3Amain)
> A lightweight implementation of IPFS over HTTP in JavaScript
# About
Exports a `createHeliaHTTP` function that returns an object that implements a lightweight version of the Helia API that functions only over HTTP.
By default, content and peer routing are requests are resolved using the [Delegated HTTP Routing API](https://specs.ipfs.tech/routing/http-routing-v1/) and blocks are fetched from [Trustless Gateways](https://specs.ipfs.tech/http-gateways/trustless-gateway/).
Pass it to other modules like @helia/unixfs to fetch files from the distributed web.
## Example
```typescript
import { createHeliaHTTP } from '@helia/http'
import { unixfs } from '@helia/unixfs'
import { CID } from 'multiformats/cid'
const helia = await createHeliaHTTP()
const fs = unixfs(helia)
fs.cat(CID.parse('bafyFoo'))
```
## Example - with custom gateways and delegated routing endpoints
```typescript
import { createHeliaHTTP } from '@helia/http'
import { trustlessGateway } from '@helia/block-brokers'
import { delegatedHTTPRouting, httpGatewayRouting } from '@helia/routers'
import { unixfs } from '@helia/unixfs'
import { CID } from 'multiformats/cid'
const helia = await createHeliaHTTP({
blockBrokers: [
trustlessGateway()
],
routers: [
delegatedHTTPRouting({
url: 'https://delegated-ipfs.dev'
}),
httpGatewayRouting({
gateways: ['https://cloudflare-ipfs.com', 'https://ipfs.io']
})
]
})
const fs = unixfs(helia)
fs.cat(CID.parse('bafyFoo'))
```
# Install
```console
$ npm i @helia/http
```
## Browser `
```
# Helia-http
# API Docs
-
# License
Licensed under either of
- Apache 2.0, ([LICENSE-APACHE](https://github.com/ipfs/helia/blob/main/packages/http/LICENSE-APACHE) / )
- MIT ([LICENSE-MIT](https://github.com/ipfs/helia/blob/main/packages/http/LICENSE-MIT) / )
# Contribute
Contributions welcome! Please check out [the issues](https://github.com/ipfs/helia/issues).
Also see our [contributing document](https://github.com/ipfs/community/blob/master/CONTRIBUTING_JS.md) for more information on how we work, and about contributing in general.
Please be aware that all interactions related to this repo are subject to the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
[](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md)