Metadata-Version: 2.4
Name: kash-docs
Version: 0.2.2
Summary: The knowledge agent shell (docs kit)
Project-URL: Repository, https://github.com/jlevy/kash-docs
Author-email: Joshua Levy <joshua@cal.berkeley.edu>
License-Expression: AGPL-3.0-or-later
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: <3.14,>=3.11
Requires-Dist: beautifulsoup4>=4.13.4
Requires-Dist: cachetools>=5.5.2
Requires-Dist: chopdiff>=0.3.1
Requires-Dist: flowmark>=0.7.2
Requires-Dist: html5lib>=1.1
Requires-Dist: kash-shell==0.4.3
Requires-Dist: markdownify>=1.2.2
Requires-Dist: pandas>=2.2.3
Requires-Dist: requests>=2.32.3
Requires-Dist: rich>=14.0.0
Requires-Dist: tenacity>=9.1.2
Requires-Dist: thefuzz>=0.22.1
Requires-Dist: typing-extensions>=4.11.1
Requires-Dist: wikipedia-api<0.11,>=0.8.1
Provides-Extra: aws
Requires-Dist: boto3>=1.38.3; extra == 'aws'
Provides-Extra: browser
Requires-Dist: browserforge>=1.2.3; extra == 'browser'
Requires-Dist: playwright-stealth>=2.0.0; extra == 'browser'
Requires-Dist: playwright>=1.54.0; extra == 'browser'
Provides-Extra: documents
Requires-Dist: markitdown[docx,pdf]>=0.1.2; extra == 'documents'
Requires-Dist: python-docx>=1.1.2; extra == 'documents'
Requires-Dist: weasyprint>=68.0; extra == 'documents'
Provides-Extra: full
Requires-Dist: boto3>=1.38.3; extra == 'full'
Requires-Dist: browserforge>=1.2.3; extra == 'full'
Requires-Dist: docling>=2.107.0; extra == 'full'
Requires-Dist: markitdown[docx,pdf]>=0.1.2; extra == 'full'
Requires-Dist: playwright-stealth>=2.0.0; extra == 'full'
Requires-Dist: playwright>=1.54.0; extra == 'full'
Requires-Dist: python-docx>=1.1.2; extra == 'full'
Requires-Dist: weasyprint>=68.0; extra == 'full'
Provides-Extra: pdf
Requires-Dist: docling>=2.107.0; extra == 'pdf'
Requires-Dist: markitdown[docx,pdf]>=0.1.2; extra == 'pdf'
Requires-Dist: python-docx>=1.1.2; extra == 'pdf'
Requires-Dist: weasyprint>=68.0; extra == 'pdf'
Description-Content-Type: text/markdown

# kash-docs

See the main [kash](https://github.com/jlevy/kash) repo for general instructions.

To run kash with text, research, and general document actions enabled, ensure you have
uv set up then:

```shell
uv tool install kash-docs --upgrade --force
kash
```

PDF/DOCX conversion and AWS publishing are optional so downstream tools such as
Deep Transcribe do not install unrelated runtimes:

```shell
uv tool install "kash-docs[documents]" --upgrade --force
uv tool install "kash-docs[aws]" --upgrade --force
uv tool install "kash-docs[full]" --upgrade --force
```

The `documents` extra provides MarkItDown, PDF rendering, and DOCX conversion. The
`full` extra also includes layout-aware PDF conversion and browser automation.

Or for dev builds from within this git repo:

```shell
# Install all deps and run tests:
make
# Run kash with all docs kit features enabled:
uv run kash
```

## Model Configuration

Document actions inherit the careful, structured, standard, and fast model roles from
kash-shell rather than selecting a provider directly. See the main
[model configuration documentation](https://github.com/jlevy/kash#model-configuration)
for the current Anthropic defaults and equivalent OpenAI settings.

For how to install uv and Python, see [installation.md](docs/installation.md).

For development workflows, see [development.md](docs/development.md).

For instructions on publishing to PyPI, see [publishing.md](docs/publishing.md).

* * *

*This project was built from
[simple-modern-uv](https://github.com/jlevy/simple-modern-uv).*

<!-- This document follows common-doc-guidelines.md.
See github.com/jlevy/practical-prose and review guidelines before editing.
-->
