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.

# 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.

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:

lvtnm headless --port 9877

Then from another device:

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

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

Notifications

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

npm install -g lvtn-mobile
lvtnm login