TiniRAG
Privacy-first RAG CLI — local LLM + SearXNG, zero cloud, zero Docker.
Install
pip install tinirag # or: pipx install tinirag
Usage
tinirag "what is Python asyncio?"
tinirag --no-search "explain transformers" # skip web search
tinirag -m llama3.2:3b "hello" # override model
tinirag chat # interactive REPL
tinirag setup # guided first-run wizard
tinirag status # show Ollama + SearXNG health
Features
- Auto-detects your installed Ollama models — no need to configure a model name; TiniRAG picks the best available one automatically (prefers instruct/chat-tuned, smallest ≥ 3b parameters)
- Privacy-first: no cloud APIs, everything runs locally
- SearXNG web search (optional) for grounded, real-time answers
- Streaming output, session memory, guardrails
Enable web search (optional)
SearXNG is not required but improves answer quality with live web results.
pipx inject tinirag searxng # if installed via pipx
# or:
pip install searxng # if installed via pip
Then run any query — TiniRAG auto-starts SearXNG on port 18888.
Requirements
- Python 3.11+
- Ollama running locally (
ollama serve) - At least one model pulled:
ollama pull llama3.2:3b
1 maintainer
Metadata
1 maintainer
Release files for tinirag 0.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tinirag-0.3.2.tar.gz | 26.8 kB | Without provenance | Details for tinirag-0.3.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tinirag-0.3.2-py3-none-any.whl | Python 3 | none | any | Details for tinirag-0.3.2-py3-none-any.whl |
Total release size: 60.8 kB
Release files / tinirag-0.3.2.tar.gz
| Download URL | tinirag-0.3.2.tar.gz |
|---|---|
| Size | 26.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
28ffa3ef6e701a28dbe181cd1928b1161596917c78b98300eb4c17eeaa659c14
|
|
BLAKE2b-256 checksum How to use checksums |
dcb3d1ff7dba8e0bc2a6fb6ec3735ba7a21dd9dfd728bea4cd860748d1004e22
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / tinirag-0.3.2-py3-none-any.whl
| Download URL | tinirag-0.3.2-py3-none-any.whl |
|---|---|
| Size | 34.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ac433e139734fac727ca74e39949c75d112eacebe9e582bb29d659976d7da1a2
|
|
BLAKE2b-256 checksum How to use checksums |
df5aa112a7a544145a0d51975fee5c841f87dc676ebede5d7a34d820d335ab87
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for tinirag 0.3.2
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.
