Skip to main content

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

Metadata

Release files for leviathantalon-chat-cli 3.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for leviathantalon-chat-cli 3.5.0
File Size Uploaded Provenance Actions
leviathantalon_chat_cli-3.5.0.tar.gz 13.9 kB Without provenance Details for leviathantalon_chat_cli-3.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for leviathantalon-chat-cli 3.5.0
File Interpreter ABI Platform Actions
leviathantalon_chat_cli-3.5.0-py3-none-any.whl Python 3 none any Details for leviathantalon_chat_cli-3.5.0-py3-none-any.whl

Total release size: 30.0 kB

Release files / leviathantalon_chat_cli-3.5.0.tar.gz

Download URL leviathantalon_chat_cli-3.5.0.tar.gz
Size 13.9 kB
Tags Source
SHA-256 checksum
How to use checksums
deb98944ee73354618d2a0fe3e97b185208ee0ca75476827d16183290250b847
BLAKE2b-256 checksum
How to use checksums
b9b66fd7ca88ed6c1cf5da431eeab6bdc9d733aee819638c66d87600af9520c1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release files / leviathantalon_chat_cli-3.5.0-py3-none-any.whl

Download URL leviathantalon_chat_cli-3.5.0-py3-none-any.whl
Size 16.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
067b3d21b69c15effb99daf92e0e1316ea5fae4b99d3eb5fafd20a6e109e72c3
BLAKE2b-256 checksum
How to use checksums
7466995fa12626f5535ce37f20b7f038b58b543670cf71761caacd53cd603c1f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Security for leviathantalon-chat-cli 3.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.5.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page