Director-AI Lite

director-ai-lite is a standalone, dependency-free LLM streaming-halt guard: it stops a token stream before a hallucination finishes generating. It installs with zero heavy dependencies (standard library only) and does not require the full director-ai package.

pip install director-ai-lite

from director_ai_lite import guard

result = guard(
    token_stream,
    facts={"capital": "Paris is the capital of France."},
    prompt="What is the capital of France?",
)

print(result.output)       # surviving text (halted tokens removed)
print(result.halted)       # True if the stream was stopped
print(result.halt_reason)  # why it was stopped

How it works

The default path is model-free: each accumulated prefix is scored by a grounding heuristic (content-word overlap against the supplied facts) and the same calibrated coherence combination the full package uses in its no-model path. The stream hard-halts on the first token whose coherence drops below threshold (default 0.5). With no facts, scoring stays neutral and nothing is halted.

Because the grounding heuristic and the coherence calibration match the full package, you can upgrade to model-backed (NLI/RAG) scoring without changing the call site.

Upgrade to model-backed scoring

pip install "director-ai-lite[full]"

Then pass the full package's scorer to StreamGuard:

from director_ai_lite import StreamGuard

guard = StreamGuard(facts=..., scorer=my_nli_scorer)  # any review(prompt, text) scorer

Tiers

Director-Lite is the free, standalone entry point. The wider product ladder:

Tier	What it is
Director-Lite	Free. This package — standalone, model-free streaming halt, zero dependencies.
Director-AI	The full runtime — model-backed NLI/RAG scoring, REST/gRPC server, framework integrations, sealed evidence packets, tamper-evident audit.
Director-AI Pro	Production-tier licence and support on top of the full runtime.
Director-AI Full	The complete advanced + labs capability set.
Director-Class AI	Separate action-control and evidence product for high-impact agent operations; scoped commercial order.

Support development ☕

Director-Lite is free forever, including in production. If it helps you, you can support development — entirely optional, and it keeps the free tier moving:

☕ Buy Me a Coffee
GitHub Sponsors

License

Apache-2.0.

Download files

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

Source Distribution

director_ai_lite-3.21.0.tar.gz (8.6 kB view details)

Uploaded Jul 29, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

director_ai_lite-3.21.0-py3-none-any.whl (7.4 kB view details)

Uploaded Jul 29, 2026 Python 3

File details

Details for the file director_ai_lite-3.21.0.tar.gz.

File metadata

Download URL: director_ai_lite-3.21.0.tar.gz
Upload date: Jul 29, 2026
Size: 8.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for director_ai_lite-3.21.0.tar.gz
Algorithm	Hash digest
SHA256	`732a46624b97837bed5331e43a5902ece0afcb9ec7ebc704d94a9b06f489eae8`
MD5	`823a5dbe30ae5fae9f1ae0ecd7233281`
BLAKE2b-256	`4c9d1dd4578d826d17025a5213c67126ea990bc1597ad584b69b7d1b7283b7ba`

See more details on using hashes here.

Provenance

The following attestation bundles were made for director_ai_lite-3.21.0.tar.gz:

Publisher: publish-lite.yml on anulum/director-ai

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: director_ai_lite-3.21.0.tar.gz
- Subject digest: 732a46624b97837bed5331e43a5902ece0afcb9ec7ebc704d94a9b06f489eae8
- Sigstore transparency entry: 2283300181
- Sigstore integration time: Jul 29, 2026
Source repository:
- Permalink: anulum/director-ai@33bd3fd8444fb80d19e56a0ae3c8c7120067cb4e
- Branch / Tag: refs/heads/main
- Owner: https://github.com/anulum
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-lite.yml@33bd3fd8444fb80d19e56a0ae3c8c7120067cb4e
- Trigger Event: workflow_dispatch