Skip to main content

ragmir

Cited local retrieval for Python agents and RAG apps. Ragmir indexes a project's code, PDFs, Office files, mail, and design files on your machine, and returns passages cited to lines, pages, slides, cells, or objects. A question the documents cannot answer returns nothing, so your application can say so instead of guessing.

pip install ragmir

Ragmir runs through Node.js 22.12 or later, or Docker. The client uses the project's own npm install of @jcode.labs/ragmir when there is one, else a global rgr, else the matching npm release through npx, else the ghcr.io/jcode-works/ragmir image. Set RAGMIR_COMMAND to choose another command.

Index a project and search it

from ragmir import Ragmir, add_sources, init_project

init_project("my-project")
add_sources("my-project", ["docs/**/*.md", "contracts/**/*.pdf"])

with Ragmir("my-project") as rag:
    rag.ingest()  # incremental: only new and changed files are read again
    for passage in rag.search("termination notice period", top_k=3):
        print(passage.citation, passage.weak_evidence)
        print(passage.text)

Ragmir keeps one MCP server running for the project and reuses it for every call. It works from any thread, a notebook, or a web framework, and each method has an async twin (asearch, aexpand, asources, astatus, aingest). Asyncio services can use AsyncRagmir directly.

  • search(query, top_k=, include_paths=, exclude_paths=, scope=) returns Passage objects with citation, path, text, line or page ranges, weak_evidence, and source_status. Path filters take folders, files, or globs such as "**/*.pdf".
  • search_many(queries) answers up to five related questions in one call.
  • expand(citation, context_radius=1) returns the passage with its neighbours; expand next_citation to read a long document through.
  • sources(paths=["contracts/**"]) lists the indexed documents; status() and audit() report readiness and coverage.
  • run_cli(project, "doctor") runs any rgr command, for example an ingest with local OCR, which Ragmir leaves to an explicit operator command.

LangChain and LlamaIndex

Read the Python guide. Ragmir is open source under AGPL-3.0-only, with a commercial license available from JCode Works.

Metadata

Release files for ragmir 6.15.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ragmir 6.15.0
File Size Uploaded Provenance Actions
ragmir-6.15.0.tar.gz 27.5 kB Without provenance Details for ragmir-6.15.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ragmir 6.15.0
File Interpreter ABI Platform Actions
ragmir-6.15.0-py3-none-any.whl Python 3 none any Details for ragmir-6.15.0-py3-none-any.whl

Total release size: 55.5 kB

Release files / ragmir-6.15.0.tar.gz

Download URL ragmir-6.15.0.tar.gz
Size 27.5 kB
Tags Source
SHA-256 checksum
How to use checksums
02c30c383aee70fb5e6dc69c84eb75c3113e2c55ed7410227320384a25117059
BLAKE2b-256 checksum
How to use checksums
2466eb7aa594461c7208318285eee3d888a84cc4b7c9e21ef651b34847d84cb6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / ragmir-6.15.0-py3-none-any.whl

Download URL ragmir-6.15.0-py3-none-any.whl
Size 28.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
86406e2aedfd7112ea0761454189d35fb12c0a64e595253326aeafd72676f4f1
BLAKE2b-256 checksum
How to use checksums
3bfe4d4a179c0d84bcbd0b21d637644ae4f6c5a4f29dad05720630cb04ebc1cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for ragmir 6.15.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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