nexroo-cli 1.6.1

CLI wrapper for ai-rooms-script with Zitadel authentication

Nexroo CLI

A command-line interface for running Nexroo Engine anywhere and interacting with the Nexroo SaaS automation platform.

CLI & Engine Documentation: docs.nexroo.ai

Website: nexroo.ai

---

Automate your processes, deploy micro-SaaS products, and scale seamless.

Nexroo platform is divided in four components, the engine and CLI, the SaaS platform, the micro-saas package and the addons.

Engine, CLI and micro-saas renderer are all free to use, all can be easily managed from our SaaS to edit with no-code editor, versionning, environments, and push multiples workflows to the deployed engine or micro-saas you are managing for your clients.

Engine Addons are open source, all viewable in nexroo-ai github repository.

Screenshots

Nexro Engine standalone usage

Standalone engine to run in any environment, most lightweight

Micro-SaaS usage

Render and deploy micro-SaaS on-premise for your clients

SaaS usage

Manage and publish client-ready revisions (no-code)

Deploy only what your client really need, manage all from one place

---

Prerequisites

Python 3.11+ is required for addon packages to work. The engine itself is a standalone binary, but addons are installed to your system Python.

• Windows: Download Python
• Linux: apt install python3 or yum install python3
• macOS: brew install python3

Installation

Quick Install (Recommended)

# install CLI
pip install nexroo-cli
# use CLI to install engine
nexroo install

or

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/nexroo-ai/nexroo-cli/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/nexroo-ai/nexroo-cli/main/install.ps1 | iex

Quick Start

After installation, authenticate and run your first workflow:

(optionnal, for SaaS features like pulling/pushing workflows revisions)

# Authenticate with Nexroo
nexroo login

Run a workflow

nexroo run workflow.json

Usage

Authentication Commands

Login

nexroo login

Opens browser for Zitadel authentication.

Logout

nexroo logout

Clears saved credentials.

Status

nexroo status

Shows authentication status and token expiration.

Workflow Management

Pull Workflow from Repository

# Pull from default Nexroo repository
nexroo workflow pull @nexroo/workflow-name

# Pull from custom repository
nexroo workflow pull @owner/repo:workflow-name

# Pull with custom name
nexroo workflow pull @nexroo/workflow-name my-custom-name

# Skip configuration during pull
nexroo workflow pull @nexroo/workflow-name --no-config

Load Local Workflow

# Load workflow from local file
nexroo workflow load ./my-workflow.json

# Load with custom name
nexroo workflow load ./my-workflow.json my-workflow

# Skip configuration
nexroo workflow load ./my-workflow.json --no-config

Configure Workflow

# Configure workflow (interactive guided process)
nexroo workflow config set my-workflow

# Show current configuration
nexroo workflow config show my-workflow

List Workflows

# List installed workflows
nexroo workflow list

# List available workflows from repository
nexroo workflow list --available

Delete Workflow

nexroo workflow delete my-workflow

Running Workflows

# Set required environment variables for secrets
export OPENAI_API_KEY=sk-...

# Run installed workflow
nexroo run my-workflow

# Run local workflow file
nexroo run workflow.json [entrypoint]

# Without authentication (local-only mode)
nexroo run workflow.json --no-auth

Additional Options

Refer to Nexroo Documentation for all available options.

Update

pip install --upgrade nexroo-cli
nexroo update

Uninstall

# Uninstall engine, addons, and all data
nexroo uninstall

# Remove the CLI package
pip uninstall nexroo-cli

Addon Packages

Installing Addons

Addons extend the engine with additional capabilities (AI providers, databases, storage, etc.).

# Install an addon
nexroo addon install redis

# List available addons
nexroo addon list --available

# List installed addons
nexroo addon list

Troubleshooting Addon Issues

If the engine can't find an addon:

1. Verify Python 3.11+ is installed:

   python3 --version
   

2. Check addon installation:

   nexroo addon list
   python3 -m pip list | grep rooms-pkg
   

3. Reinstall addon:

   nexroo addon install <addon_name> --upgrade
   

Storage Locations

• Engine: Installed via pip to Python's site-packages (available as nexroo-engine or nexroo run)
• Addon packages: System Python's site-packages
• Workflows: ~/.nexroo/workflows/
• Workflow configurations: ~/.nexroo/workflows/*.config.json
• Encrypted tokens: ~/.nexroo/auth_token.enc
• Encryption key: ~/.nexroo/.key
• Addon metadata: ~/.nexroo/installed_packages.json
• Engine version: ~/.nexroo/.engine_version
• Download cache: ~/.nexroo/cache/

Troubleshooting

For debug use '--verbose'

Authentication fails

nexroo logout
nexroo login

Token expired

nexroo status
nexroo login   # Re-authenticate

Documentation

See Nexroo Engine Documentation to know how to use Nexroo workflow engine.

License

Nexroo Engine Free Use License v1.0 - see LICENSE file for details.

Support

• GitHub Issues: https://github.com/nexroo-ai/nexroo-cli/issues

Contact

Adrien EPPLING
mail: [e-mail]
linkedin: https://www.linkedin.com/in/adrien-eppling/

Romain MICHAUX
mail: [e-mail]
linkedin: https://www.linkedin.com/in/romain-michaux/