β οΈ WARNING: Internal Use Only & Work In Progressβ οΈ This repository is intended for internal use only and is currently a work in progress. Features and documentation may be incomplete or subject to change. Please ensure you have the necessary permissions and understand the implications of using unreleased or unstable features.
The Quix CLI is a free tool that enables you to create, debug, and run streaming pipelines locally using Docker and Quix Streams.
It also serves as a companion app for seamlessly managing and interacting with the features of your Quix Cloud{target=_blank} account. While Quix Cloud offers a robust Frontend UI for a user-friendly experience, the CLI empowers you with efficiency and flexibility, allowing you to streamline your workflow and take control from the command line.
Quix CLI offers three groups of functionality:
- Local commands
- Cloud commands
- Utility commands
Using the local commands, you can create your pipeline with predefined samples or write your code from scratch in Python, leveraging the power of Quix Streams. The CLI allows you to run these pipelines locally in Docker containers for testing and debugging. Optionally, you can deploy and synchronize your local pipeline to Quix Cloud.
Using the cloud commands, you can manage your Quix Cloud account from the command line. While Quix Cloud offers a robust frontend UI for a user-friendly experience, the CLI provides efficiency and flexibility, allowing you to streamline your workflow and take control from the command line. The CLI aims to offer feature parity with the Quix Cloud UI, although some Quix Cloud functionalities are only available through the CLI, such as:
- Permissions - Management of user permissions against the resources
- Auditing - Users auditing data
With the utility commands, you can perform tasks such as checking your status, updating the CLI, changing the CLI configuration, using interactive help, and managing contexts (the endpoint or environment the CLI is connected to).
For a quick tutorial of how to use the basic functionalities of Quix CLI, visit CLI Quickstart.
For more information and detailed documentation, visit quix.io.
To install the Quix CLI, users have multiple methods depending on their operating system. Here's an expanded installation section including the main ways to install Quix CLI on Linux, macOS, and Windows.
-
Install latest version:
curl -fsSL https://github.com/quixio/quix-cli/raw/main/install.sh | bash
-
Install with explicit version:
curl -fsSL https://github.com/quixio/quix-cli/raw/main/install.sh | bash -s -- -v={version}
-
Install latest version:
curl -fsSL https://github.com/quixio/quix-cli/raw/main/install.sh | bash
-
Install with explicit version:
curl -fsSL https://github.com/quixio/quix-cli/raw/main/install.sh | bash -s -- -v={version}
-
Install latest version:
iwr https://github.com/quixio/quix-cli/raw/main/install.ps1 -useb | iex
-
Install with explicit version:
$quixCliInstall = (iwr https://github.com/quixio/quix-cli/raw/main/install.ps1 -useb).Content; $version="{version}"; iex "$quixCliInstall"
- Version Specification: Replace
{version}
with the actual version number you intend to install (e.g.,1.2.3
). Omitting the{version}
parameter will automatically default to installing the latest available version of Quix CLI. You have the option to install the latest version or specify a particular version according to your needs. To view and choose from all available versions, visit the releases section. - PATH Verification: After installation, ensure that the directory where Quix CLI is installed is included in your system's PATH.
- Go to the release page and dowload the executable matching your OS/architecture.
- Copy the executable to a location of your choice.
- Add the location to your system's PATH.
in order to get a list of available commands run:
quix --help
You have 2 ways of logging in:
- Interactive login
quix login
This will open the browser in order to complete the login.
- PAT Token
quix login <patToken>
After setting up your context and logging in you will be able to access your Quix organisation. For more information visit Quix Docs.
The CLI will use the Serverless platform as the default context: https://portal-api.platform.quix.io/
For Dedicated or BYOC Quix clusters you can add your own context by running:
quix contexts add <name> <portalEndpoint>
Select it using the following command:
quix contexts use <name>
If you run into any problems, please create an issue or ask in #quix-help in our Quix Community on Slack.
Join other software engineers in The Stream, an online community of people interested in all things data streaming. This is a space to both listen to and share learnings.
π Join our Slack community!
You can follow us on Twitter and Linkedin where we share our latest tutorials, forthcoming community events and the occasional meme.
If you have any questions or feedback - write to us at support@quix.io!