Fluvio is a lightweight high-performance distributed data streaming system written in Rust and Web Assembly.

Quick Start - Get started with Fluvio in 2 minutes or less!

Step 1. Download Fluvio Version Manager:

On your terminal run

curl -fsS https://hub.infinyon.cloud/install/install.sh | bash

Follow the instructions and copy/paste the path to the bin directory to your startup script file.

Fluvio version manager will give you the ability to download different versions of Fluvio:

• Including our read-only edge cluster with built-in compression, caching, and mirroring to never lose data even with extended downtimes.
• Or our Developer Preview of Stateful Streaming which we are building using the web assembly component model to support all web assembly compatible languages.

Step 2. Start local cluster:

The following command will start a local cluster by default:

fluvio cluster start

Step 3. Create Topic:

The following command will create a topic called hello-fluvio:

fluvio topic create hello-fluvio

Step 4. Produce to Topic, Consume From Topic:

Produce data to your topic. Run the command first and then type some messages:

fluvio produce hello-fluvio
> hello fluvio
Ok!
> test message
Ok!

Consume data from the topic, Run the following command in a different terminal:

fluvio consume hello-fluvio -B -d

Just like that! You have a local cluster running.

Using Pre-Build Fluvio Versions

You may want to prefer other Fluvio versions than the latest stable release. You can do so by specifying the version in the VERSION environment variable.

Install Latest Release (as of master branch)

$ curl -fsS https://hub.infinyon.cloud/install/install.sh | VERSION=latest bash

Install Specific Version

$ curl -fsS https://hub.infinyon.cloud/install/install.sh | VERSION=x.y.z bash

Next Steps

Now that you have a cluster running you can try building data flows in different paradigms.

Check Fluvio Core Documentation

Fluvio documentation will provide additional context on how to use the Fluvio clusters, CLI, clients, a development kits.

• Fluvio docs home
• Fluvio CLI docs home
• Fluvio Architecture

Learn how to build custom connectors

Fluvio can connect to practically any system that you can think of.

• For first party systems, fluvio clients can integrate with the edge system or application to source data.
• For third party systems fluvio connectors connect at the protocol level and collects data into fluvio topics.

Out of the box Fluvio has native http, webhook, mqtt, kafka inbound connectors. In terms of outbound connectors out of the box Fluvio supports SQL, DuckDB, Graphite, experimental builds of Redis, S3 etc.

Using Connector Development Kit, we built our existing connectors in a matter of few days. Check out the docs and let us know if you need help building any connector.

• Connector docs
• Connector Development Kit (cdk) docs

Learn how to build custom smart modules

Fluvio applies wasm based stream processing and data transformations. We call these reusable transformation functions smart modules. Reusable Smart modules are built using Smart Module Development Kit and can be distributed using InfinyOn Cloud hub.

• Smart Modules docs
• Smart Modules Development Kit (smdk) docs

There are some limitations on the amount of polyglot development interface support. While bindings can be generated for wasm compatible languages, there are quirks in that approach. We have a better solution with Stateful Service Development Kit, which we are implementing using the web assembly component model. In the upcoming releases we will be able to natively support all wasm compatible programming languages.

• Stateful Service Development Kit docs- Coming Soon Request Developer Preview Invite

Try workflows on InfinyOn Cloud

InfinyOn Cloud is Fluvio on the cloud as a managed service. All new users get $3000 worth of credits to build data flows on InfinyOn Cloud.

• Check InfinyOn Cloud Guides
• Check out experimental data flows on InfinyOn Labs Repo

Clients

• Fluvio Client API docs home

Language Specifc API docs:

• Rust API docs
• Python API docs
• Javascript API docs
• Java API docs

Community Maintained:

• Go API docs
• Java API docs
• Elixir API docs

Contributing

If you'd like to contribute to the project, please read our Contributing guide.

Community

Many fluvio users and developers have made projects to share with the community. Here a a few listed below:

Projects Using Fluvio

• Swiftide Project: a Rust native library for building LLM applications
• Real Time Stock Charts: See how Fluvio is used to update real time stock charts

Community Connectors

• Qdrant Connector
• Google Sheets Connector: Send data from Fluvio to Google Sheets
• Elastic Connector: Send data from Fluvio to Elastic Search

Community Development Resources

• Hello World Fluvio Connector: Sample Fluvio connector template to build your own connector
• Gurubase: Third-party AI/LLM Docs query

Contributors are awesome

Made with contrib.rocks.

License

This project is licensed under the Apache license.