Skip to main content

L41: Terminal chat REPL + HTTP API server. Run the entire swarm from a terminal like Claude Code, or from your app via REST.

Project description

L41 — Terminal Chat + HTTP API Server

Run the entire LeviathanTalon swarm from a terminal or from your app.

Terminal REPL (like Claude Code)

leviathantalon chat          # or: lvtn chat
leviathantalon chat --profile large --provider ollama
🐉 LeviathanTalon v3.5 | 41 layers | 1,286 integrations | profile: medium

> /status
  HaChazal (Da'at)    ONLINE   caps=7    subs=7/7
  Uriel (Netzach)     ONLINE   caps=4    sniper: paper-mode
  Katan (Malkuth)     ONLINE   caps=12   L40: DISARMED (paper)

> @uriel sniper.safety_gauntlet mint=DOGGO
  [C2] command c8a3f → uriel → dispatched → completed (4.2ms)
  output: {ok: true, stage: safety_gauntlet, would_run: true}

> /transfer file:///home/chaz/report.pdf sftp://chaz@win/C:/Desktop/report.pdf --password $PW
  [Bridge] ✓ file_to_sftp (8,201 bytes, SHA-256 verified)

> /arm
  [Safety] ✓ ARMED (token: a3f8..., watchdog: 100ms)

> /providers
  ✓ ollama          llama3.2        local (ready)
  ✗ anthropic       claude-sonnet   ANTHROPIC_API_KEY not set
  ✗ openai          gpt-4o-mini     OPENAI_API_KEY not set

> Tell me about this token's safety profile   (natural language → LLM routes it)
  [LLM → HaChazal] intent: analyze_token_safety, target: uriel
  [C2] command d9b2a → uriel → completed
  ...

> /quit

Three input modes

Mode Syntax LLM needed?
Slash commands /status, /arm, /transfer src dst, /providers, /history, /quit No
Direct dispatch @sub_name capability_name key=value key2=value2 No
Natural language Any other text → sent to LLM head for intent extraction → C2 dispatch Yes (falls back to "no LLM wired" error)

HTTP API Server

leviathantalon serve --port 8708    # or: lvtn serve

Endpoints:

  • POST /api/chat{"message": "..."} → same routing as terminal REPL
  • POST /api/command{"target_sub": "uriel", "capability": "...", "args": {...}} → direct C2 dispatch
  • GET /api/status — full swarm status (subs, registry, mesh, balancer, ethics, safety)
  • GET /api/providers — list all LLM providers with availability
  • GET /api/integrations — list all registered integrations
  • POST /api/arm — ARM the safety interlocks
  • POST /api/disarm — DISARM
  • GET /api/health — liveness probe

All responses are JSON. CORS enabled for local dev.

Run locally on a VPS

# 1. Clone or unzip the swarm
unzip leviathantalon-PRODUCTION-ELITE-v3.5.zip
cd leviathantalon-swarm

# 2. Install everything
pip install -e .lpls/baseline -e .lpls/patches/0001* ... -e .lpls/patches/0041*
# Or use the install-all script (coming in v3.6)

# 3. Set your LLM provider (any ONE is enough)
export ANTHROPIC_API_KEY=sk-...     # or:
# ollama pull llama3.2              # free local LLM

# 4. Set VPS profile
export LEVIATHAN_PROFILE=medium     # or small / large

# 5. Start the chat
leviathantalon chat

# 6. Or start the API server for your app
leviathantalon serve --port 8708

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

leviathantalon_chat_cli-3.5.0.tar.gz (13.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

leviathantalon_chat_cli-3.5.0-py3-none-any.whl (16.1 kB view details)

Uploaded Python 3

File details

Details for the file leviathantalon_chat_cli-3.5.0.tar.gz.

File metadata

  • Download URL: leviathantalon_chat_cli-3.5.0.tar.gz
  • Upload date:
  • Size: 13.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for leviathantalon_chat_cli-3.5.0.tar.gz
Algorithm Hash digest
SHA256 deb98944ee73354618d2a0fe3e97b185208ee0ca75476827d16183290250b847
MD5 3aa95b6d42be25019af83923c2e2b39a
BLAKE2b-256 b9b66fd7ca88ed6c1cf5da431eeab6bdc9d733aee819638c66d87600af9520c1

See more details on using hashes here.

File details

Details for the file leviathantalon_chat_cli-3.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for leviathantalon_chat_cli-3.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 067b3d21b69c15effb99daf92e0e1316ea5fae4b99d3eb5fafd20a6e109e72c3
MD5 d9b2732ae2c42fc85e65d8fe5e8e6397
BLAKE2b-256 7466995fa12626f5535ce37f20b7f038b58b543670cf71761caacd53cd603c1f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page