pipeless

Requirements ☝️

• Python. Pre-built binaries are linked to Python 3.10 in Linux amd64, 3.8 in Linux arm64, and 3.12 in macOS. If you have a different Python version, provide the --build flag to the install script to build from source so Pipeless links to your installed Python version (or update your version and use a pre-built binary, which is simpler).
• Gstreamer 1.20.3. Verify with gst-launch-1.0 --gst-version. Installation instructions here

Installation 🛠️

curl https://raw.githubusercontent.com/pipeless-ai/pipeless/main/install.sh | bash

Find more information and installation options here.

Using docker

Instead of installing locally, you can alternatively use docker and save the time of installing dependencies:

docker run miguelaeh/pipeless --help

To use it with CUDA:

docker run miguelaeh/pipeless:latest-cuda --help

To use with TensorRT use:

docker run miguelaeh/pipeless:latest-tensorrt --help

Find the whole container documentation here.

Getting Started 🚀

Init a project:

pipeless init my_project --template scaffold
cd my_project

Start Pipeless:

pipeless start --stages-dir .

Provide a stream:

pipeless add stream --input-uri "https://pipeless-public.s3.eu-west-3.amazonaws.com/cats.mp4" --output-uri "screen" --frame-path "my-stage"

The code generated is an empty template that scafold a stage so it will do nothing. Please go to the examples to complete that stage.

You can also use the interactive shell to create the project:

Check the complete getting started guide or plunge into the complete documentation.

License 📄

This project is licensed under the Apache License 2.0.

Apache License 2.0 Summary

The Apache License 2.0 is a permissive open-source license that allows you to use, modify, and distribute this software for personal or commercial purposes. It comes with certain obligations, including providing attribution to the original authors and including the original license text in your distributions.

For the full license text, please refer to the Apache License 2.0.