Metadata-Version: 2.4
Name: lvtn-mobile
Version: 1.0.3
Summary: Leviathan Shel HaShem â€” Mobile Swarm Client for Termux/Android. Backend-heavy thin client with offline task scheduling, headless remote control, and full 708-agent swarm access from your phone.
Project-URL: Homepage, https://lvtn.metanoiaunlimited.com
Author-email: "HaChazal (Chaz Leland Hamm)" <hachazal418@metanoiaunlimited.com>
License: Proprietary - Metanoia Unlimited LLC
Keywords: agent,android,background,headless,mobile,orchestration,scheduler,swarm,termux
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: Android
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: System :: Distributed Computing
Requires-Python: >=3.9
Requires-Dist: aiohttp>=3.9
Provides-Extra: full
Requires-Dist: lvtn>=3.14; extra == 'full'
Provides-Extra: notify
Requires-Dist: plyer>=2.1; extra == 'notify'
Description-Content-Type: text/markdown

# lvtn-mobile — Termux/Android Swarm Client

The full 708-agent Leviathan swarm, on your phone. Backend-heavy — all LLM compute runs server-side. Your phone is the remote control.

```bash
# Termux one-time setup
pkg update && pkg upgrade
pkg install python termux-api termux-boot
pip install lvtn-mobile
lvtnm login
```

## Commands

| Command | What it does |
|---------|-------------|
| `lvtnm login` | Authenticate with your Leviathan key |
| `lvtnm chat "prompt"` | Send a prompt to HaChazal |
| `lvtnm fleet "task"` | Deploy all 7 Angels at once |
| `lvtnm council "task"` | All Angels answer in parallel |
| `lvtnm swarm zadkiel "task"` | Deploy one Angel's swarm |
| `lvtnm schedule "task"` | Queue a task for offline execution |
| `lvtnm schedule-list` | List scheduled tasks |
| `lvtnm schedule-run` | Execute all queued tasks now |
| `lvtnm headless` | Start HTTP server for remote control |
| `lvtnm status` | Show swarm health + scheduled tasks |
| `lvtnm balance` | Check KTRS balance |
| `lvtnm angels` | List all 7 Angels |
| `lvtnm remember "text"` | Write to HiveMind memory |
| `lvtnm recall "query"` | Search HiveMind memory |
| `lvtnm notify on\|off` | Toggle Android notifications |
| `lvtnm wake on\|off` | Toggle wake lock (keep phone awake) |
| `lvtnm boot on\|off` | Toggle auto-start on device boot |

## Offline Mode

Tasks queued while offline execute automatically when connectivity returns. Uses a background watcher thread that checks every 30 seconds.

```bash
lvtnm schedule "research Solana DeFi trends" --type fleet
# Queued. Will execute when online.
```

## Headless Mode (Remote Control)

Start an HTTP server on your phone, control the swarm from any device on the same network:

```bash
lvtnm headless --port 9877
```

Then from another device:
```bash
curl http://192.168.1.100:9877/fleet -d '{"task":"audit the lead gen pipeline"}'
curl http://192.168.1.100:9877/status
```

## Auto-Start on Boot

```bash
lvtnm boot on
# Headless server starts automatically when your phone boots
```

## Notifications

```bash
lvtnm notify on
# Get Android notifications when scheduled tasks complete
```

## Architecture

```
Phone (Termux)                    Server (api.leviathansi.xyz)
┌─────────────────┐              ┌──────────────────────────┐
│ lvtn-mobile     │   HTTPS      │ Leviathan Backend        │
│                 │ ◄──────────► │                          │
│ • chat          │              │ • 708 LLM agents         │
│ • fleet         │   aiohttp    │ • 2,124 binary claws     │
│ • council       │              │ • HiveMind memory        │
│ • schedule      │              │ • KTRS metering          │
│ • headless      │              │ • All compute            │
│                 │              │                          │
│ Background      │              │ Your phone does nothing  │
│ watcher thread  │              │ heavy — just HTTP calls  │
└─────────────────┘              └──────────────────────────┘
```

## Dependencies

Only one: `aiohttp` for async HTTP. No `rich`, no `prompt_toolkit`, no heavy TUI libs. Designed for Termux's limited environment.

## Install from npm

```bash
npm install -g lvtn-mobile
lvtnm login
```
