Zuni
Zuni is a terminal research assistant that combines an OpenAI-compatible LLM with web search and source citations.
Features
- Ask questions from the terminal
- Search the web automatically
- Extract readable page content for the model
- Return answers with source citations
- Use any compatible OpenAI-style API endpoint
Installation
Requires Python 3.11 or newer.
Using uv:
uv tool install ssannssar.zuni
Or install into an environment:
uv add ssannssar.zuni
Configuration
Set your API key:
zuni config --api-key YOUR_API_KEY
You can also configure the model and API base URL:
zuni config --model YOUR_MODEL --base-url YOUR_BASE_URL
Environment variables are supported too:
export ZUNI_API_KEY="YOUR_API_KEY"
export ZUNI_BASE_URL="https://your-provider.example/v1"
Usage
Ask a question:
zuni ask "What is quantum computing?"
Skip web search:
zuni ask --no-search "Explain recursion"
Control the number of search results:
zuni ask -n 3 "Latest developments in Python"
See all commands and options:
zuni --help
zuni ask --help
Documentation
Full documentation is available at:
https://ssannssarr.github.io/Zuni/
Development
Clone the repository and install the project with its development dependencies:
git clone https://github.com/ssannssarr/Zuni.git
cd Zuni
uv sync
Run the CLI from the project environment:
uv run zuni --help
License
Zuni is released under the MIT License. See LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for ssannssarr.zuni 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ssannssarr_zuni-0.1.0.tar.gz | 15.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ssannssarr_zuni-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 36.6 kB
Release files / ssannssarr_zuni-0.1.0.tar.gz
| Download URL | ssannssarr_zuni-0.1.0.tar.gz |
|---|---|
| Size | 15.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2cf9de70e074515705e060ed4cc0bff824b83e6010c96c483c8073e2c0e9391a
|
|
BLAKE2b-256 checksum How to use checksums |
52004c6629f48fed412fd14a04100ecdca3371f37437abef9b4ab24e291c4674
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / ssannssarr_zuni-0.1.0-py3-none-any.whl
| Download URL | ssannssarr_zuni-0.1.0-py3-none-any.whl |
|---|---|
| Size | 21.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9eec25134fec090db1dc4b06cec014b8067a6661b9638a64a9ba9b076754741a
|
|
BLAKE2b-256 checksum How to use checksums |
93abe9a1c8bffdbd797b25b69044e5a700ad92c8191c6c524cc70322bb74a2de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
