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

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