Metadata-Version: 2.4
Name: honest-scholar
Version: 0.0.0a1
Summary: honest-scholar — a CLI for honest, defensible AI-assisted research (tooling for the honest-scholar plugin)
Project-URL: Homepage, https://github.com/davorrunje/honest-scholar
Project-URL: Repository, https://github.com/davorrunje/honest-scholar
Project-URL: Issues, https://github.com/davorrunje/honest-scholar/issues
Author-email: Davor Runje <davor@synthpop.ai>
Maintainer-email: Davor Runje <davor@synthpop.ai>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: claude-code,cli,dataset,literature,research,science
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Science/Research
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.15,>=3.11
Requires-Dist: pooch>=1.8
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests>=2.31
Requires-Dist: typer>=0.12
Provides-Extra: mcp
Description-Content-Type: text/markdown

# honest-scholar

*Research you can defend.*

**honest-scholar** helps you keep research honest — especially now that AI is in
the loop. You (not the AI) make and sign off every material decision, and you must
be able to explain and defend the work; the tool keeps the accounts, advises, and
probes. It **supports** honest, disclosable AI-assisted research — it does **not**
certify that any work is honest.

This package is the **CLI / tooling** behind the
[`honest-scholar` Claude Code plugin](https://github.com/davorrunje/honest-scholar).
The plugin (skills + methodology) stays pure-markdown; this package provides the
`honest-scholar` command it calls — `literature`, `dataset`, `defend`, `backlog`,
and `doctor` — installed **isolated**, so it never touches your project's ML
environment.

## Install

```bash
uv tool install honest-scholar     # recommended (isolated tool env)
# or: pipx install honest-scholar
# or: pip install honest-scholar

honest-scholar --version
honest-scholar doctor              # reports python / uv / rclone
```

Pre-releases are on TestPyPI (`--index-url https://test.pypi.org/simple/
--extra-index-url https://pypi.org/simple/`).

## CLI

```
honest-scholar --version
honest-scholar doctor                                        # environment report (implemented)
honest-scholar literature resolve|cites|refs|enrich|neighbors   # issue #1
honest-scholar dataset    validate|ingest|emit                    # issue #2
honest-scholar dataset    fetch|verify|mirror|audit               # issue #3
honest-scholar defend     record                                # issue #4
honest-scholar backlog    park|add|list|rank|promote|drop       # issue #5
```

Currently only `doctor` and `--version` are implemented; the domain sub-commands
are typed stubs exiting with a pointer to their tracking issue.

## Learn more

- **Plugin, docs, and full design record:** <https://github.com/davorrunje/honest-scholar>
- **User guide:** <https://github.com/davorrunje/honest-scholar/blob/main/docs/USER-GUIDE.md>
- **Disclose your AI use & cite honest-scholar:** <https://github.com/davorrunje/honest-scholar/blob/main/DISCLOSURE.md>

## Status

Early / pre-release — see
<https://github.com/davorrunje/honest-scholar/blob/main/STATUS.md>.

## License

[Apache-2.0](https://github.com/davorrunje/honest-scholar/blob/main/LICENSE).
