- π₯ Purpose and goals
- πββοΈ Getting Started
- π API Docs
- π Code Structure
- π£ Project status
- π£οΈ Roadmap
- π« Get involved
- ποΈ Notable Consumers/Users
- π Name
- πͺͺ License
A lean, modular, and modern implementation of IPFS for the prolific JS and browser environments.
See the Manifesto, the FAQ, and the State of IPFS in JS blog post from October 2022 for more info.
Check out the Helia examples repo, which covers a wide variety of use cases. If you feel something has been missed, follow the contribution guide and create a PR to the examples repo.
Helia embraces a modular approach and encourages users to bring their own implementations of interfacing libraries to suit their needs. Helia also ships supplemental libraries and tools including:
These libraries are by no means the "one true implementation", but instead instead provide optionality depending on one's needs.
This repo itself is made up of these packages:
/packages/interfaceThe Helia API/packages/heliaAn implementation of the Helia API/packages/interopInterop tests for Helia
Helia v1 shipped in 202303 (see releases), and development keeps on trucking as we work on initiatives in the roadmap and make performance improvements and bug fixes along the way.
Please find and comment on the Roadmap here.
- Watch our Helia Demo Day presentations here
- We are sharing about the progress at periodic Helia Demos. This is a good place to find out the latest and learn of ways to get involved. We'd love to see you there!
- Pick up one of the issues.
- Come chat in Filecoin Slack #ip-js. (Yes, we should bridge this to other chat enviornments. Please comment here if you'd like this.)
Contributions welcome! Please check out the issues.
Also see our contributing document 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.
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.
Helia is in its early days. If you're using Helia in production or have a novel usecase, we'd love to hear. Please open an issue so we can learn more!
Helia (HEE-lee-ah) is the Latin spelling of Ἡλιη -- in Greek mythology, one of the Heliades: the daughters of the sun god Helios. When their brother Phaethon died trying to drive the sun chariot across the sky, their tears of mourning fell to earth as amber, which is yellow (sort of), and so is JavaScript. They were then turned into poplar trees and, well, JavaScript is quite popular.
In OctβDec 2022, PL EngRes IP Stewards sought community input for the name of this project. After considering 20 suggestions and holding a couple of polls, the name Helia was chosen. Here's why "ipfs" is not in the name.
Licensed under either of
- Apache 2.0, (LICENSE-APACHE / http://www.apache.org/licenses/LICENSE-2.0)
- MIT (LICENSE-MIT / http://opensource.org/licenses/MIT)