npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@storacha/elizaos-plugin

v1.2.1

Published

Storacha Storage Plugin for ElizaOS

Readme

@storacha/elizaos-plugin

A plugin providing distributed storage functionality for ElizaOS agents.

Description

The Storacha plugin enables agents to interact with a distributed storage network, allowing for file uploads and retrieval.

Installation

npx elizaos plugins add @elizaos-plugins/plugin-storacha

Configuration

  1. Add the plugin to the Agent configuration, e.g.

    // eliza/agent/src/defaultCharacter.ts
    
    export const defaultCharacter: Character = {
        name: "Eliza",
        username: "eliza",
        plugins: ["@elizaos-plugins/plugin-storacha"],
        ...
    };
  2. Create the env var file

    cp .env.example agent/.env
  3. Generate and set the Agent Private Key

    w3 key create
    • Copy the private key (e.g., MgCYJE...Ig3Kk=) and set it to the STORACHA_AGENT_PRIVATE_KEY env var.
    • Copy the Agent DID key (e.g., did:key:...) to create the Agent Delegation.
  4. Create the Agent Delegation

    • Replace AGENT_DID_KEY with the DID Key you copied in the previous step and execute:
    w3 delegation create AGENT_DID_KEY \
     --can 'store/add' \
     --can 'filecoin/offer' \
     --can 'upload/add' \
     --can 'space/blob/add' \
     --can 'space/index/add' | base64
    • Copy the base64 encoded content and set it to the STORACHA_AGENT_DELEGATION env var.
  5. Set the model

    • If you are starting from scratch you may want to use OpenRouter API to provide the LLM Model for the Agent.
    • Just create an account and API key at: https://openrouter.ai
    • Then set the OPENROUTER_API_KEY env var.
    • The default agent character is already configured to use OpenRouter.

Build & Run

  1. Build and start the agent from the project root folder
pnpm install --no-frozen-lockfile && pnpm build && pnpm start
  1. In another terminal start the Web Client to interact with the agent
pnpm start:client
  1. Open http://localhost:5173 in browser and have fun

Features

1. File Upload

  • STORAGE_UPLOAD action for uploading files to the Storacha network
  • Supports multiple file types and sizes
  • Provides a link to access uploaded files

2. File Retrieval

  • STORAGE_RETRIEVE action for reading files from the IPFS based on a CID.
  • Embeds the file in the Agent response as an attachment, so the user can download it.

Development

  1. Clone the repository

  2. Install dependencies

pnpm install
  1. Build the plugin
pnpm run build

Dependencies

  • @elizaos/core: workspace:*

Future Enhancements

  • Conversation History & Agent Context Backup
  • Cross Agent Data Sharing
  • Encryption with LIT Protocol

Storacha Client

You can access the Storacha Client directly from the agent code if the plugin is enabled in the character file, see the Quickstart for AI guide for more info.

License

MIT & Apache 2