Metadata-Version: 2.4
Name: researchzosho
Version: 0.5.0
Summary: Python client for ResearchZosho, an open-source deep research assistant with citations and memory. It searches your library, starts research runs and reads their results over HTTP, with no dependencies.
License: Apache-2.0
Project-URL: Homepage, https://researchzosho.org
Project-URL: Source, https://github.com/Wyrdsekai/researchzosho
Project-URL: Documentation, https://github.com/Wyrdsekai/researchzosho/blob/main/docs/LIBRARIAN_HOWTOUSE.md
Project-URL: Changelog, https://github.com/Wyrdsekai/researchzosho/blob/main/CHANGELOG.md
Keywords: deep-research,research-assistant,citations,literature-review,mcp,local-llm
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# researchzosho (Python)

**ResearchZosho** — 研究蔵書, the research holdings. The Research Harness For The Rest Of Us.

A thin client for The Librarian over HTTP — the library protocol, contract 1.0
(`docs/LIBRARY_PROTOCOL.md`). Transport and types only; the library's one implementation lives
in the daemon. No dependencies beyond the standard library.

```python
from researchzosho import Librarian, LibraryError

lib = Librarian("http://127.0.0.1:4649", token="…")   # token from `researchzosho reader token <did>`
pkg = lib.ask("How do subtitlers handle keigo?")
if pkg["holds_nothing"]:
    print("nothing held")
for e in pkg["entries"]:
    print(e["id"], e["kind"], e["state"], e["title"])

v = lib.established("Keigo has no direct English equivalent")
print(v["verdict"], [a["id"] for a in v["accepted"]], [d["id"] for d in v["unreviewed"]])

text = lib.read("https://example.org/paper.pdf", max_chars=4000)["text"]

job = lib.research("What did Japanese sources say about keigo in subtitles after 2020?")
result = lib.wait(job["job_id"])          # an overnight ask; poll or wait
```

Every result carries `library_id`, `library_name`, `contract`. Errors raise `LibraryError` with
`.code` in `not_found | forbidden | no_sources | invalid_args | unavailable` and a message you
can show to a person.

`pip install researchzosho`. The CLI is `researchzosho` (`zosho` for short).
