Kjell Tore Guttormsen
69dc51fa89
Version 0.8.3 -> 0.8.4 in pyproject.toml, __init__.py and uv.lock, and the guard pin in [tool.uv.sources] moved from v1.3.0 to v1.4.0 (uv.lock follows via `uv lock`: the guard's version, source and requires-dist lines, nothing else). CHANGELOG [Unreleased] closed as [0.8.4] with K3-21's and K3-22's entries moved as written, plus one entry for the guard pin: 1.4.0 parses a flow sequence of plain scalars that 1.3.0 refused (26 of 28 frontmatter blocks refused by 1.3.0, 0 of 28 by 1.4.0, on one five-document bundle). Dependency range llm-ingestion-guard>=1.2,<2.0 unchanged. README: the four install lines and llms.txt's one to @v0.8.4, the guard pairing prose to v0.8.4 / v1.4.0, the pip fallback to @v1.4.0, a v0.8.4 row as the current tag (seventeen checker rules), and the suite count (1783 collected, 1782 passed, 1 skipped) with its history extended. No behaviour change in src/ beyond the version string. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
34 lines
1.5 KiB
Text
34 lines
1.5 KiB
Text
# llm-ingestion-okf
|
|
|
|
> Turn a folder of documents (PDF, DOCX, XLSX, PPTX, MD) into a bundle a model can answer from with a source on every claim. Offline and deterministic: no model call anywhere in the run path. Security is delegated to llm-ingestion-guard.
|
|
|
|
Requires Python 3.10+ and [uv](https://docs.astral.sh/uv/). Neither this package
|
|
nor the guard it depends on is on a package index yet; one command resolves both:
|
|
|
|
```sh
|
|
uv tool install "llm-ingestion-okf[extract] @ git+https://git.fromaitochitta.com/open/llm-ingestion-okf.git@v0.8.4"
|
|
```
|
|
|
|
Then, in the folder you want to work from:
|
|
|
|
```sh
|
|
okf project ~/my-documents
|
|
claude
|
|
```
|
|
|
|
`okf project` writes the bundle to `.okf/<id>/` and a Claude Code skill to
|
|
`.claude/skills/<id>-consume/` in the current directory. Start `claude` there
|
|
and ask in plain language. Three shapes of request are supported and the
|
|
generated skill states the rules for each: a **question**, a **hypothesis**
|
|
(answered per premise as `confirmed` / `refuted` / `undecidable-from-bundle`),
|
|
and a **task whose answer is a document** (every claim in the written file
|
|
carries its source; an ungrounded paragraph is written and marked, never
|
|
dropped).
|
|
|
|
## Docs
|
|
|
|
- [Consume in Claude Code](README.md#consume-in-claude-code): the same thing in
|
|
steps, several bundles in one project, and what was measured.
|
|
- [README](README.md): the pip-only fallback if uv is unavailable, the guard
|
|
pairing per tag, the build flags, phase status, and the upstream OKF version
|
|
policy.
|