Metadata-Version: 2.4
Name: nwo-robotics
Version: 2.2.0
Summary: CLI tool for NWO Robotics API v2.0
Home-page: https://nwo.capital
Author: NWO Robotics
Author-email: ciprian.pater@publicae.org
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0.0
Requires-Dist: requests>=2.25.0
Requires-Dist: rich>=10.0.0
Requires-Dist: pydantic>=1.8.0
Requires-Dist: pyyaml>=5.4.0
Requires-Dist: websockets>=10.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# NWO Robotics CLI

[![PyPI version](https://badge.fury.io/py/nwo-robotics.svg)](https://badge.fury.io/py/nwo-robotics)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](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

```bash
pip install nwo-robotics
```

## Quick Start

```bash
# 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:

```bash
# 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](WIROS-INTEGRATION.md) for detailed documentation.

## Speech Integration

The NWO CLI supports speech recognition and synthesis:

```bash
# 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

- Python 3.8+
- API key from [NWO Capital](https://nwo.capital/webapp/api-key.php)

## License

Apache 2.0 - See [LICENSE](LICENSE) for details.

## Support

- Website: https://nwo.capital
- Email: ciprian.pater@publicae.org
- Issues: https://github.com/RedCiprianPater/nwo-robotics-cli/issues
