z8run-cli 0.2.0

CLI for z8run — visual flow engine for workflow automation, AI pipelines, and IoT. Install with: cargo install z8run-cli
z8run-cli-0.2.0 is not a library.

z8run-cli

Main CLI binary for z8run. Wires together all crates to provide a single executable for running the server, managing plugins, and validating flows.

Installation

From crates.io

cargo install z8run-cli

From source

git clone https://github.com/z8run/z8run.git
cd z8run
cargo build --release --bin z8run

With Docker

docker pull ghcr.io/z8run/z8run-api:latest
docker run -p 7700:7700 ghcr.io/z8run/z8run-api:latest

Commands

z8run serve                            # Start the server (default port 7700)
z8run serve -p 8080                    # Custom port
z8run migrate                          # Run database migrations
z8run plugin list                      # List installed plugins
z8run plugin install ./my-plugin.wasm  # Install a WASM plugin
z8run plugin install ./plugin-dir/     # Install from directory with manifest.toml
z8run plugin remove my-plugin          # Remove a plugin
z8run plugin scan                      # Scan plugin directory
z8run validate flow.json               # Validate a flow file (DAG check)
z8run info                             # Show version and system info

Configuration

Variable Default Description
Z8_PORT 7700 HTTP/WebSocket port
Z8_BIND 0.0.0.0 Bind address
Z8_DATA_DIR ./data Data directory (database, plugins)
Z8_DB_URL SQLite auto Database URL (sqlite:// or postgres://)
Z8_LOG_LEVEL info Log level (trace, debug, info, warn, error)
Z8_JWT_SECRET JWT signing secret (required for PostgreSQL)
Z8_VAULT_SECRET Encryption key for the credential vault

Quick start

cp .env.example .env
z8run serve

Open http://localhost:7700 in your browser to access the visual flow editor.

License

Apache-2.0 OR MIT