Skip to content

Security: Wyrdsekai/researchzosho

SECURITY.md

Security

Reporting

If you find a security problem in ResearchZosho, write to security@researchzosho.org. Say what you found and how to see it. You will get a reply, and a fix or an explanation, before anything is made public.

What a release is, and how to check one

A release is one file, researchzosho-X.Y.Z.tar.gz, published on GitHub with a SHA256SUMS file beside it. The one-line installers download both from the same release. They refuse to install anything the checksums do not match.

After a release is published, the project's own GitHub workflow signs the tarball with Sigstore. It uploads researchzosho-X.Y.Z.tar.gz.sigstore.json beside the tarball. The signature means "the ResearchZosho release workflow, at this tag, approved these exact bytes". It does not say the workflow built them. The artifact is built and tried on real machines first, and the signature says so.

To check a download yourself, with the GitHub CLI (2.49 or newer):

gh attestation verify researchzosho-X.Y.Z.tar.gz --repo Wyrdsekai/researchzosho \
  --predicate-type https://researchzosho.org/attestation/release/v1

Without --predicate-type the command looks for build provenance. This project does not produce that. The command then prints its failure only to a terminal. Always pass the flag.

What the program reaches out to

  • The model server you name, and only that one. Your API key, if you set one, is sent to that server's host and nowhere else.
  • The web, when you ask it to research or when a saved search runs. It refuses to fetch addresses on your own machine, link-local addresses, and the addresses of its own services. RESEARCHZOSHO_FETCH_PRIVATE=deny makes it refuse your whole private network too.
  • Public record services, when a document carries a DOI, an arXiv id or a PubMed id, to look up its citation.

Everything it keeps is in the library folder on your disk. Nothing is sent anywhere to be stored.

There aren't any published security advisories