https://github.com/tenzir/library

The Tenzir Community Library.
https://github.com/tenzir/library

datapipeline etl pipelines secdataops secops

Last synced: 17 days ago
JSON representation

The Tenzir Community Library.

• Host: GitHub
• URL: https://github.com/tenzir/library
• Owner: tenzir
• Created: 2023-12-13T13:03:04.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2025-08-02T16:28:14.000Z (7 months ago)
• Last Synced: 2025-08-02T18:35:24.556Z (7 months ago)
• Topics: datapipeline, etl, pipelines, secdataops, secops
• Homepage: https://app.tenzir.com/library
• Size: 652 KB
• Stars: 5
• Watchers: 8
• Forks: 3
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 📚 Tenzir Library

This repository contains a collection of open-source

[packages](https://docs.tenzir.com/explanations/packages/) for Tenzir.

## ✨ Why packages matter

- Package once, deploy anywhere: ship pipelines, contexts, and operators as a

  single unit.

- Built-in templating keeps packages environment-agnostic while still

  customizable on install.

- Tests and examples travel with the package so behaviour stays predictable.

Learn more about the concept in the [packages

explanation](https://docs.tenzir.com/explanations/packages/).

## 🧱 Package anatomy

A package lives in a directory with these building blocks:

- `examples/`: runnable snippets that highlight the package’s capabilities.

- `operators/`: user-defined operators (UDOs) you can reuse across pipelines.

- `pipelines/`: end-to-end TQL pipelines that start with an input and finish

  with an output operator.

- `tests/`: deterministic integration tests that verify UDOs and pipelines via

  the [test framework](https://docs.tenzir.com/reference/test-framework).

- `package.yaml`: the manifest with metadata, configurable inputs, and optional

  enrichment contexts.

## 🚀 Install packages

Pick the workflow that fits your environment. For details, see our [installation

guide](https://docs.tenzir.com/guides/package-management/install-a-package/):

1. **Tenzir Library UI**: browse

   [app.tenzir.com/library](https://app.tenzir.com/library), configure inputs,

   and click _Install_.

2. **Interactive TQL**: run

   [`package::add`](https://docs.tenzir.com/reference/operators/package/add)

   against a local directory, and remove it later with

   [`package::remove`](https://docs.tenzir.com/reference/operators/package/remove).

3. **Infrastructure as Code**: place packages under `packages/` inside your

   configuration directory (or another path listed in `tenzir.package-dirs`) and

   include an optional `config.yaml` for inputs.

## 🤝 Contribute a package

Follow the [write-a-package

tutorial](https://docs.tenzir.com/tutorials/write-a-package/) to scaffold, test,

and document a new idea, then:

- Share it on the [Community Discord](https://docs.tenzir.com/discord) to gather

  feedback.

- Open a pull request in

  [github.com/tenzir/library](https://github.com/tenzir/library) so the package

  appears in the public Tenzir Library.

- Keep iterating—tests and good docs make it easier for others to adopt your

  work.