Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jreyesr/n8n-nodes-opencv

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/jreyesr/n8n-nodes-opencv
Owner: jreyesr
License: apache-2.0
Created: 2024-10-15T03:04:24.000Z (3 months ago)
Default Branch: master
Last Pushed: 2024-10-24T02:26:20.000Z (3 months ago)
Last Synced: 2024-11-06T23:24:52.598Z (3 months ago)
Language: TypeScript
Size: 4.49 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        # n8n-nodes-opencv

This is an N8N community node. It lets you use [OpenCV.js](https://docs.opencv.org/3.4/df/d0a/tutorial_js_intro.html) (a

version of OpenCV that can run in browsers and Node.JS environments) in your N8N workflows.

OpenCV is an open-source image processing library that contains lots of computer vision algorithms.

This node exposes some common OpenCV operations so they can be used in N8N workflows.

For example:

* Image binarization/thresholding:

	![simple binarization](docs/binarization.png)

* Binary operations (e.g. NOT):

	![bitwise NOT on binary image](docs/not.png)

* Morphological operators (erosion, dilation, opening, closing):

	![erosion performed on a binary image](docs/erosion.png)

* Histogram computation

	![a grayscale histogram computed on a color image](docs/histogram.png)

* Various blurring algorithms

	![an image being blurred with a Gaussian blur](docs/blur.png)

* Edge detection algorithms (e.g. Canny, Laplacian)

	![the Canny algorithm used to detect the edges in an image](docs/canny.png)

* Contour detection

	![an image with contours drawn on top of it](docs/contours.png)

[Installation](#installation)  

[Resources](#resources)  

[Development](#development)

## Installation

Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community

nodes documentation.

## Resources

* [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)

* [OpenCV.js docs](https://docs.opencv.org/3.4/d5/d10/tutorial_js_root.html)

## Development

1. Clone the repo:

	 ```

	 git clone https://github.com/jreyesr/n8n-nodes-opencv.git

	 ```

2. Run `pnpm i` to install dependencies.

3. Open the project in your editor.

4. Make changes, fix bugs, or add new operations. To add a new operation:

	* If adding a new operation on an existing module (e.g. another thresholding algorithm), add it

		on `nodes/OpenCvNode/actions//.operation.ts`, and register it

		on `nodes/OpenCvNode/actions//index.ts`

	* If adding an entirely new module (a broad set of OpenCV functionality, e.g. "object tracking" or "DNNs"), add it

		on `nodes/OpenCvNode/actions/`, and register the new module

		on `nodes/OpenCvNode/OpenCvNode.node.ts`

5. Run `pnpm lint` to check for errors or `pnpm lintfix` to automatically fix errors when possible.

6. Test the node locally. Refer

	 to [Run your node locally](https://docs.n8n.io/integrations/creating-nodes/test/run-node-locally/) for guidance.

7. (jreyesr only) [Publish](https://docs.npmjs.com/packages-and-modules/contributing-packages-to-the-registry) the

	 package to npm.

## License

[Apache License v2.0](LICENSE.txt)