Metadata-Version: 2.4
Name: doctrail
Version: 0.3.1
Summary: SQLite database enrichment tool using LLMs
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: aiohttp
Requires-Dist: anthropic>=0.40
Requires-Dist: beautifulsoup4
Requires-Dist: chardet
Requires-Dist: claude-agent-sdk>=0.1.45
Requires-Dist: click>=8.0
Requires-Dist: ebooklib>=0.18
Requires-Dist: fastapi>=0.115.0
Requires-Dist: google-genai>=1.0.0
Requires-Dist: jinja2
Requires-Dist: krippendorff>=0.7
Requires-Dist: loguru
Requires-Dist: lxml>=5.0
Requires-Dist: mhtml-to-html-py
Requires-Dist: openai
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: prompt-toolkit<3.0.52
Requires-Dist: pyalex>=0.18
Requires-Dist: pydantic>=2.0
Requires-Dist: pymupdf>=1.24
Requires-Dist: pypinyin>=0.54.0
Requires-Dist: python-docx>=1.0
Requires-Dist: python-pptx>=1.0.2
Requires-Dist: pyyaml
Requires-Dist: pyzotero
Requires-Dist: questionary>=2.0
Requires-Dist: readability-lxml>=0.8
Requires-Dist: rich
Requires-Dist: sqlite-fts4
Requires-Dist: sqlite-utils
Requires-Dist: tiktoken
Requires-Dist: tqdm>=4.0
Requires-Dist: typer
Requires-Dist: uvicorn[standard]>=0.32.0
Requires-Dist: xlrd>=2.0.2
Provides-Extra: icr
Provides-Extra: ocr
Requires-Dist: ocrmypdf>=16.0; extra == 'ocr'
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-asyncio; extra == 'test'
Requires-Dist: pytest-mock; extra == 'test'
Requires-Dist: respx; extra == 'test'
Description-Content-Type: text/markdown

# Doctrail

<table align="right" border="0" cellspacing="0" cellpadding="0">
<tr><td><img src="docs/assets/mascot.png" alt="A doctrail mascot, courtesy of DALL-E 3" width="150"></td></tr>
<tr><td align="center"><sub>A doctrail mascot,<br>courtesy of DALL-E 3</sub></td></tr>
</table>

Doctrail turns document collections into auditable, structured research data with LLMs.

It ingests files into an SQLite database, applies structured codebooks and prompts to selected rows, runs them through an LLM (OpenAI, Gemini, Anthropic, or OpenRouter models), and returns ordinary tables and views for iteration and analysis.

Doctrail is meant to be driven by both researchers and coding agents.

## Start here

For researchers and users, the documentation is at <https://doctrail.dev>.

For LLMs and coding agents, the complete operating manual is at <https://doctrail.dev/llms.txt>.

## Install

Install the command line tool:

```bash
uv tool install doctrail
doctrail --help
```

Or run directly:

```bash
uvx doctrail
```

From source:

```bash
git clone https://github.com/mpr1255/doctrail
cd doctrail
uv run doctrail --help
```

## Documentation

The full documentation is at [https://doctrail.dev](https://doctrail.dev).

Inside the package, `doctrail docs` prints the reference documentation offline.

## License

MIT
