---
title: ML Claw TUI Demo
emoji: 🐾
colorFrom: blue
colorTo: purple
sdk: static
app_file: app.py
pinned: false
license: mit
---

# ML Claw TUI Demo

A terminal user interface (TUI) for managing ML Claw deployments on Hugging Face Spaces.

## Features

- **Dashboard**: Overview of your ML Claw deployment
- **Bootstrap**: Create or update HF Space deployments
- **Gateway**: Start/stop/restart gateway operations
- **State**: Manage deployment state buckets
- **Models**: Configure inference models
- **Settings**: Update hardware and sleep settings

## Installation

```bash
# Install ML Claw with TUI support
npm install -g mlclaw

# Or clone and build from source
git clone https://github.com/huggingface/mlclaw.git
cd mlclaw
npm install
npm run build
```

## Usage

```bash
# Launch the TUI
mlclaw-tui

# Or use the CLI
mlclaw bootstrap
mlclaw gateway start my-agent
mlclaw gateway status my-agent
```

## Quick Start

1. Authenticate with Hugging Face:
   ```bash
   hf auth login
   ```

2. Launch the TUI:
   ```bash
   mlclaw-tui
   ```

3. Follow the interactive prompts to deploy your agent

## Keyboard Shortcuts

- `1-6`: Switch tabs
- `Alt+Left/Right`: Cycle tabs
- `Tab/Shift+Tab`: Navigate fields
- `Enter`: Confirm/Select
- `Ctrl+T`: Theme selector
- `Ctrl+D`: Toggle dark/light mode
- `q`: Quit

## Architecture

ML Claw deploys OpenClaw agents to Hugging Face Spaces with durable state in private Storage Buckets. The TUI provides a terminal-based interface for managing deployments.

## Links

- [ML Claw Repository](https://github.com/huggingface/mlclaw)
- [OpenClaw Documentation](https://github.com/huggingface/openclaw)
- [Hugging Face Spaces](https://huggingface.co/spaces)