ChunkSmith CLI — modular indexing, storage, and document Q&A.
Project description
chunksmith-cli (Python)
PyPI package chunksmith-cli v0.6.0 — modular Rich terminal for ChunkSmith indexing, storage, and document Q&A.
Part of the ChunkSmith monorepo (packages/chunksmith-cli).
What's new in 0.6.0
-
Minimal core install —
pip install chunksmith-cliinstalls only the CLI shell +chunksmith-core -
Modular extras — pick pipelines and features at install time
-
chunksmith install— interactive extra picker (runs pip/uv for you) -
Dynamic menus — only shows modes for installed packages
-
Slash commands —
/exit,/back,/revertat any prompt (also without/) -
Stepped wizards —
/revertrewinds to the previous configure/indexing step
Install profiles
| Command | What you get |
|---------|----------------|
| pip install chunksmith-cli | Core CLI: configure, doctor, install, View saved JSON |
| pip install "chunksmith-cli[unstructured]" --pre | + Unstructured pipeline |
| pip install "chunksmith-cli[pageindex]" | + PageIndexer |
| pip install "chunksmith-cli[online]" | + Mongo/S3 adapters |
| pip install "chunksmith-cli[agent]" | + Document Q&A |
| pip install "chunksmith-cli[indexing]" --pre | Both indexing pipelines |
| pip install "chunksmith-cli[all]==0.6.0" --pre | Full product |
After a minimal install:
chunksmith install # pick extras interactively
chunksmith configure # LLM + storage wizard
chunksmith doctor # verify env + installed packages
chunksmith # main menu (modes depend on installed extras)
Migration from 0.5.x
pip install --upgrade "chunksmith-cli[all]==0.6.0" --pre
# or
uv tool install "chunksmith-cli[all]==0.6.0" --prerelease=allow --force
Package layout (loose coupling)
| Package | Extra | Enables |
|---------|-------|---------|
| chunksmith-core | (base) | configure, doctor, view |
| chunksmith-multimodal | [unstructured] | Unstructured pipeline |
| chunksmith-pageindex | [pageindex] | PageIndexer |
| chunksmith-adapters | [online] | Mongo + S3 storage |
| chunksmith-agent | [agent] | Document Q&A |
Navigation commands
At any text prompt or yes/no menu:
| Command | Action |
|---------|--------|
| /exit or exit | Quit CLI immediately |
| /back or back | Return to main menu |
| /revert or revert | Re-edit previous wizard step |
Environment variables
LLM (LiteLLM gateway)
| Variable | Purpose |
|----------|---------|
| CHUNKSMITH_LLM_MODEL | e.g. azure/gpt-4o, openai/gpt-4o |
| API_KEY | Provider API key |
| API_BASE | Custom endpoint (Azure / proxy) |
| API_VERSION | Azure API version |
Storage
| Variable | Purpose |
|----------|---------|
| CHUNKSMITH_STORAGE_MODE | auto (default), local, or online |
| CHUNKSMITH_LOCAL_DATA_DIR | Override local data root |
Development
cd ChunkSmith
uv sync
uv run chunksmith
Tests
cd ChunkSmith
uv run pytest packages/chunksmith-cli/tests -q
Publish to PyPI (maintainers)
From ChunkSmith repo root, in dependency order:
$pkgs = @(
"packages\chunksmith-core",
"packages\chunksmith-multimodal",
"packages\chunksmith-pageindex",
"packages\chunksmith-adapters",
"packages\chunksmith-agent",
"packages\chunksmith-cli"
)
foreach ($p in $pkgs) { Push-Location $p; uv build; uv publish .\dist\*0.6.0*; Pop-Location }
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file chunksmith_cli-0.6.42.tar.gz.
File metadata
- Download URL: chunksmith_cli-0.6.42.tar.gz
- Upload date:
- Size: 105.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.13 {"installer":{"name":"uv","version":"0.9.13"},"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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1feee830c96b55969f3d6ea1f085c31fd86919dfbb468117ad2762e3dbce7f06
|
|
| MD5 |
79b0ce3845477f5680ceb96b012fd264
|
|
| BLAKE2b-256 |
a189cd612ef5c7b25964dbfb256b03a18e2a4a2812022966d1fb57e5d909cad9
|
File details
Details for the file chunksmith_cli-0.6.42-py3-none-any.whl.
File metadata
- Download URL: chunksmith_cli-0.6.42-py3-none-any.whl
- Upload date:
- Size: 118.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.13 {"installer":{"name":"uv","version":"0.9.13"},"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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a7e8fd301bbd2d3c2ce022716f4276e2cec78f59bcc12e6ee070efc311fba7bf
|
|
| MD5 |
0dfc0ab4e557fea67e00bc16aad2b04e
|
|
| BLAKE2b-256 |
548a5a5edc16e79b11688fba31a8ea1480c0ce651f27585fbd2ea3a5a1a44d2d
|