Skip to main content

Lohra

A self-improving AI agent runtime — persistent memory, self-authored skills, and a declarative multi-agent workflow harness with Claude-Code-grade rigor. Runs headless: CLI, structured orchestration envelope, and an OpenAI-compatible server. No UI required.

pip install lohra          # Python 3.11–3.13
lohra chat "hello"

Four entry points, none of them a UI

Port Command For
Human CLI lohra chat you, in a terminal
Orchestration envelope lohra chat --json other agents/scripts — one parseable JSON per turn (input/output/reasoning/tool_calls/usage)
OpenAI-compatible API lohra serve any OpenAI client becomes a Lohra client
WS/REST gateway lohra dashboard optional, only if a UI attaches

What makes it interesting

  • Dynamic workflows as inert data: the agent authors a typed DAG (10 node types — agent, parallel, pipeline, loop_until_dry, verify, judge_panel, gate, completeness_check, checkpoint, nested workflow) that an interpreter runs. No agent-authored code is ever executed; escape is inexpressible, not forbidden.
  • Failure is never silent: every failure path produces a fault with its cause; run status is honest (complete | degraded | failed | cancelled | paused).
  • Never pay twice: content-addressed per-cell cache — a resumed run replays completed work at zero token cost, across process restarts.
  • Human in the loop: checkpoint nodes pause a run until a person answers — in another terminal, another process, another day. Durable state + single-winner leases.
  • Cost control: token budgets with soft pre-spawn gates, quota pauses with auto-resume, per-node model/effort/provider routing, operator-owned model tiers.
  • Self-improving: persistent memory, self-authored skills, and a workflow library that turns clean runs into reusable templates and bad runs into recorded priors.
  • Leaf sandbox: filesystem allowlist (ro/rw), egress allowlist, and taint tracking — operator policy, never the spec.

Configuration

State lives in ~/.lohra (or per-workspace via --profile): .env (API keys) · workflow_policy.json (leaf fs/egress) · workflow_tiers.json (model tiers). Providers out of the box: Anthropic, OpenAI, OpenRouter, DeepSeek, Groq, Together, Gemini, Ollama — plus an opt-in subscription mode (see the ToS warning in lohra auth).

Driving Lohra from another agent? lohra skill export use-lohra --to .claude/skills (or --to .codex/skills) drops the delegation kit — a skill teaching Codex CLI / Claude Code how to hand Lohra self-contained work through lohra chat --json.

MIT license. Alpha software — built and validated live, but young.

Download files

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

Source Distribution

lohra-0.0.7.tar.gz (452.2 kB view details)

Uploaded Source

Built Distribution

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

lohra-0.0.7-py3-none-any.whl (321.5 kB view details)

Uploaded Python 3

File details

Details for the file lohra-0.0.7.tar.gz.

File metadata

  • Download URL: lohra-0.0.7.tar.gz
  • Upload date:
  • Size: 452.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.5

File hashes

Hashes for lohra-0.0.7.tar.gz
Algorithm Hash digest
SHA256 5eac9b66d1427aa196f8c5c11977935c58a7aea23b97b9f69837d4c810a698a9
MD5 930b15c7fa5761a73616245866f20bd4
BLAKE2b-256 4cda06944b339b25a993634ff720b56bb39a9a63c76e328eb6773a32279be46f

See more details on using hashes here.

File details

Details for the file lohra-0.0.7-py3-none-any.whl.

File metadata

  • Download URL: lohra-0.0.7-py3-none-any.whl
  • Upload date:
  • Size: 321.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.5

File hashes

Hashes for lohra-0.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 5523d7a673cd1191082c86d0506d83d8c97a0a2c4bc7520dc6050b9ee981c362
MD5 b3929cc64c4bf3bc1692a324e0c3d59f
BLAKE2b-256 0578547c5b5da284005e4bca1852b266d971b4efddc6f8edb4ead89cde1c89d0

See more details on using hashes here.

Release history Release notifications | RSS feed

0.0.9

2 files

0.0.8

2 files

This release

0.0.7 This release

2 files

0.0.6

2 files

0.0.5

2 files

0.0.4

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

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