Skip to main content

CLI tool for NWO Robotics API v2.0

Project description

NWO Robotics CLI

PyPI version Python 3.8+ License

Command-line interface for the NWO Robotics API - control robots, manage swarms, and orchestrate intelligent automation with natural language.

Features

  • 🤖 Robot Control - Natural language commands for any supported robot
  • 🌐 Swarm Management - Coordinate multi-robot teams
  • 🧠 AI Models - Access VLA (Vision-Language-Action) models
  • 📡 IoT Integration - Sensor fusion with robot commands
  • 📶 WiFi Sensing - WiROS integration for CSI/RSSI sensing
  • 👤 Human Detection - RuView WiFi-based pose and vital signs
  • 🎙️ Speech - STT/TTS with Whisper, Piper, and voice cloning
  • 🔒 Safety Systems - Built-in collision avoidance and ethics engine
  • 📊 Online Learning - Continuous RL from telemetry

Installation

pip install nwo-robotics

Quick Start

# Authenticate
nwo auth login

# Control a robot with natural language
nwo robot "pick up the box and place it on the table"

# List available AI models
nwo models list

# Create a robot swarm
nwo swarm create "Warehouse Team"

# Enable WiFi sensing
nwo sensor wiros enable --interface wlan0

# Speech-to-text
nwo speech stt transcribe recording.wav

# Text-to-speech
nwo speech tts synthesize "Task completed" --voice en_US-amy-medium -o done.wav

# Clone a voice
nwo speech clone create --sample my_voice.wav --name my_clone

Commands

Command Description
nwo auth Authentication and API key management
nwo robot Send commands to robots
nwo swarm Multi-robot swarm management
nwo models AI model management
nwo iot IoT sensor integration
nwo sensor WiFi sensing (WiROS, RuView)
nwo speech Speech recognition and synthesis
nwo tasks Task queue management
nwo learning Online RL and fine-tuning
nwo safety Safety and ethics controls
nwo monitor Real-time telemetry
nwo config CLI configuration

WiFi Sensing

The NWO CLI integrates with WiROS for WiFi-based sensing:

# Enable WiROS CSI sensing
nwo sensor wiros enable --interface wlan0 --mode csi

# View available topics
nwo sensor wiros topics

# Stream CSI data
nwo sensor wiros stream /nwo/wiros/csi --to-topic /nwo/sensors/wifi_csi

# Extract bearing information
nwo sensor wiros bearing --algorithm music

# Multi-sensor fusion
nwo sensor fusion --sensors wiros --sensors ruview

See WIROS-INTEGRATION.md for detailed documentation.

Speech Integration

The NWO CLI supports speech recognition and synthesis:

# Speech-to-text with Whisper
nwo speech stt transcribe recording.wav --language en

# Text-to-speech with Piper
nwo speech tts synthesize "Hello world" --voice en_US-amy-medium -o hello.wav

# Clone a voice (6+ seconds of audio)
nwo speech clone create --sample my_voice.wav --name my_clone

# Use cloned voice with XTTS
nwo speech tts synthesize "Hello" --voice my_clone --engine xtts

# Direct robot speech
nwo speech speak "Moving to kitchen" --robot unitree_g1_001

Features:

  • STT: Whisper (cloud or local whisper.cpp)
  • TTS: Piper TTS (fast, local, MIT licensed)
  • Voice Cloning: Coqui XTTS v2 (6-second samples)
  • 14 languages supported

API Documentation

  • API Base: https://nwo.capital/webapp
  • Documentation: https://nwo.capital/docs
  • Dashboard: https://nwo.capital/webapp/api-key.php

Requirements

License

Apache 2.0 - See LICENSE for details.

Support

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nwo_robotics-2.2.0-py3-none-any.whl (31.8 kB view details)

Uploaded Python 3

File details

Details for the file nwo_robotics-2.2.0-py3-none-any.whl.

File metadata

  • Download URL: nwo_robotics-2.2.0-py3-none-any.whl
  • Upload date:
  • Size: 31.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for nwo_robotics-2.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d140547deb96c938abcafb726efab714916a7a2bbe7ff60b10234ad3a59d4e64
MD5 812e59ec4e7829a5a658a6429421734d
BLAKE2b-256 8e32e3f2dccd51d23d64e0b36812e1f43b292ae5e0b2ec42a923c50b3ed6c7fb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page