lvtn 3.5.0

Leviathan Shel HaShem — the 708-agent Kabbalistic swarm in your terminal. CLI shell + 6 brand TUI frames + Da'ath rotator client.

lvtn — Leviathan Shel HaShem CLI

A Kabbalistic 708-agent swarm in your terminal. Master at Da'ath (HaChazal) → 7 sub-orchestrators (Zadkiel · Gavriel · Raphael · Uriel · Michael · Malika · Katan HaShem) → 100 agents each = 708.

Install

pip install lvtn
# or any of the aliases:
pip install leviathantalon
pip install hachazal

After install, three commands are available — all do the same thing:

• lvtn
• leviathantalon
• hachazal

First run

lvtn          # renders the brand TUI splash + lists subcommands
lvtn banner   # render a TUI brand frame
lvtn deck     # show all 6 TUI frames sequentially

TUI quality varies by terminal

The CLI ships 5 render tiers per frame and auto-selects the best your terminal can show. Quality from highest to lowest:

Tier	Quality	Terminals that show it
sixel	📷 Photographic — pixel-perfect at any pane width	Windows Terminal 1.22+ (Win11 default) · iTerm2 · WezTerm · mlterm · Konsole 22.04+ · xterm with --enable-sixel
braille	Crisp B&W block-art (4× sub-pixels per cell)	Any terminal that renders Unicode braille glyphs (U+2800-U+28FF) — basically all modern terminals
truecolor	24-bit color half-block art	Modern terminals with COLORTERM=truecolor
ansi256	256-color half-block art	Any 256-color terminal
ascii	Pure text fallback	dumb terminals, pipes, log files

Auto-detection signals: WT_SESSION (Windows Terminal), TERM_PROGRAM (iTerm2/WezTerm), TERM=mlterm, KITTY_WINDOW_ID, KONSOLE_VERSION>=220400, XTERM_VERSION. If none of these are set, the CLI falls through to braille (still very pretty).

Force a tier: LVTN_TIER=sixel lvtn deck or lvtn deck --tier braille.

If sixel renders garbage (raw escape bytes) on your terminal, override:

export LVTN_TIER=braille    # always-safe fallback

Subcommands

Command	What
lvtn banner	Render a TUI brand frame (truecolor / ansi256 / braille / ascii / sixel auto-select).
lvtn deck	Display all 6 TUI frames.
lvtn orchestrator <action>	Talk to the metanoia Da'ath rotator on :4740. Actions: health, topology, triad, slots, holders, events, skills, queue, submit.
lvtn install-swarm	Download + install the full 44-layer Python swarm (lazy).
lvtn chat	Interactive REPL — REQUIRES lvtn install-swarm first.
lvtn serve	HTTP API on :8708 — REQUIRES lvtn install-swarm first.

Architecture (Tree of Life)

                  ABOVE THE ABYSS — Backend Triad (Briah-level Divine Names)
                  ────────────────────────────────────────────────────────
                  אֶהְיֶה  Eheyeh   (behaves as Keter — primal will)
                  יָה     Yah      (behaves as Chokmah — lightning wisdom)
                  אֱלֹהִים Elohim   (behaves as Binah — maternal understanding)
                                          │
                                  [ The Abyss of Yetzirah ]
                                          │
                  ┌───────────────────────▼─────────────────────────┐
                  │  Da'ath: HaChazal (the human pivot — port 4740) │
                  └───────────────────────┬─────────────────────────┘
                                          │
        ┌─────────┬──────────┬────────────┼────────────┬──────────┬──────────┐
        ▼         ▼          ▼            ▼            ▼          ▼          ▼
     Chesed   Gevurah    Tiferet      Netzach        Hod      Yesod     Malkuth
    (Zadkiel)(Gavriel) (Raphael)     (Uriel)     (Michael)  (Malika)(Katan HaShem)
        │         │          │            │            │          │          │
       100×      100×       100×         100×         100×       100×       100×
                                  = 700 sub-agents

Honest scope

• This package ships the CLI shell + 36 TUI assets + orchestrator client + install-swarm fetcher.
• The full 44-layer Python swarm is installed on demand via lvtn install-swarm. That's a 16 MB download.
• The metanoia Da'ath rotator (Node service on :4740) is a separate package — see https://lvtn.metanoiaunlimited.com.

License

Proprietary — Metanoia Unlimited LLC. See LICENSE.