Juturna – Real-time AI Pipeline Framework

Important to know

Juturna is actively evolving with exciting new features and improvements being added regularly. We're using semantic versioning to clearly communicate any breaking changes between releases, so you can upgrade with confidence.

At a glance

Juturna is a data pipeline library written in Python. It is particularly useful for fast prototyping multimedia, real-time data applications, as well as exploring and testing AI models, in a modular and flexible fashion.

Among its many features, there are a few keypoints to highlight about Juturna:

• Real-Time Streaming: continuously process audio, video and arbitrary data streams
• Modularity: create your own nodes and share them as Python packages
• Composable workloads: design pipelines to solve complex tasks in minutes
• Parallelism & Batching: parallel, non-blocking execution for high throughput
• Observability: built-in logging and metrics support

Quick start

Juturna needs Python 3.12 or newer.

pip install juturna          # the core library and its CLI
pip install juturna-nodes    # the officially supported nodes

A pipeline is a JSON file that lists nodes and the links between them:

{
  "version": "3.0.0",
  "pipeline": {
    "name": "http_echo",
    "id": "http_echo_01",
    "folder": "./run",
    "nodes": [
      { "name": "receiver", "type": "JsonHTTP", "configuration": {} },
      { "name": "delay", "type": "PassthroughIdentity", "configuration": {} }
    ],
    "links": [
      { "from": "receiver", "to": "delay" }
    ]
  }
}

python -m juturna validate --config pipeline.json
python -m juturna launch --config pipeline.json

The documentation has a tutorial that builds a pipeline from scratch, nodes included, and a guide to upgrade from Juturna 2.x.

Documentation: https://meetecho.github.io/juturna/index.html

Contribute: https://github.com/meetecho/juturna/blob/main/CONTRIBUTING.md

Meetecho: https://www.meetecho.com/en/

Contributing

We are so glad you decided to contribute! We truly value your time and help in making Juturna better, and look forward to every single PR, whether you are fixing typos, proposing the next big feature, or extending the documentation.

To make sure we’re all on the same page and to get your changes merged as quickly as possible, please take a peek at our CONTRIBUTING.md guide. It covers the essentials, including:

• branching & PR workflow
• code style & linting
• issue triage (TBD)
• issue & PR templates and a Code of Conduct are provided (TBD)
• signing CRA

If you are not sure where to start, feel free to open an issue to discuss your ideas first. We’re happy to help guide you through the process!

Changelog

All notable changes are documented in CHANGELOG.md - we follow Semantic Versioning, so you'll always know how exactly updates affect your setup.

License

Distributed under the MIT License. See LICENSE for details.