Metadata-Version: 2.5
Name: nexus-scholar
Version: 1.0.0
Summary: Single umbrella package: the Nexus Scholar harness CLI and the eight scholar-* kit packages behind one uvx command.
Project-URL: Repository, https://github.com/nexus-scholar-org/nexus-scholar-harness
Project-URL: Releases, https://github.com/nexus-scholar-org/nexus-scholar-harness/releases
Project-URL: Documentation, https://github.com/nexus-scholar-org/nexus-scholar-harness/blob/main/docs/nexus_scholar_user_guide.md
Project-URL: Homepage, https://github.com/nexus-scholar-org/nexus-scholar-harness
Author-email: Nexus Scholar Org <nexus-scholar@users.noreply.github.com>
License: MIT
Keywords: MCP,PRISMA,RAG,evidence synthesis,literature review,meta-analysis,scientific literature,systematic review
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
Requires-Python: >=3.11
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: bibtexparser>=2.0.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: hishel==0.0.32
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp>=1.0.0
Requires-Dist: networkx>=3.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyvis>=0.3.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tenacity>=8.0.0
Requires-Dist: typer>=0.9.0
Requires-Dist: uvicorn>=0.30.0
Description-Content-Type: text/markdown

# nexus-scholar

Agent-native, audited systematic literature review orchestration in a single
installable wheel.  The `nexus-scholar` metapackage bundles the harness CLI,
all eight `scholar-*` research kits, and twelve skill bundles so a workspace
initialized anywhere is self-contained and portable.

## What is inside

- **`nexus-scholar` CLI** -- scaffold workspaces, wire AI agents (MCP), log
  audit events, run health checks.
- **`scholar-agent` MCP server** -- exposes discovery, screening, RAG, graph,
  verification, and synthesis tools to any Model Context Protocol client.
- **8 research kits** -- search, protocol, PDF, bibliography, RAG, graph,
  verification, and agent kits.
- **12 skill bundles** -- PRISMA, workspace-manager, inception-agent,
  methodology-copilot, and more.

## Install

**Prerequisite:** [uv](https://docs.astral.sh/uv/) 0.12+.

### Zero-friction (uvx)

```sh
uvx --from https://github.com/nexus-scholar-org/nexus-scholar-harness/releases/download/v1.0.0/nexus_scholar-1.0.0-py3-none-any.whl nexus-scholar --help
```

### Persistent install

```sh
uv tool install --from https://github.com/nexus-scholar-org/nexus-scholar-harness/releases/download/v1.0.0/nexus_scholar-1.0.0-py3-none-any.whl nexus-scholar
```

## Quick start

```sh
# Scaffold a workspace
nexus-scholar init "My Systematic Review" --dir ~/projects/my-review --scaffold-only

# Health check
nexus-scholar doctor --workspace ~/projects/my-review --exit-code

# Record an audit event
nexus-scholar log event ~/projects/my-review --action PROJECT_INITIALIZED --agent me --description "started review"

# Wire MCP into your AI client
nexus-scholar setup-mcp --workspace ~/projects/my-review --harness all
```

## Commands

| Command | Purpose |
|---------|---------|
| `nexus-scholar init` | Scaffold a portable research workspace in any folder |
| `nexus-scholar doctor` | Health-check kits, keys, skills, and layout |
| `nexus-scholar log` | Append audit events and refresh the project index |
| `nexus-scholar setup-mcp` | Generate MCP config for Claude, Cursor, VS Code, and more |

## Documentation

See the [User Guide](https://github.com/nexus-scholar-org/nexus-scholar-harness/blob/main/docs/nexus_scholar_user_guide.md)
for full instructions, configuration reference, and troubleshooting.

## License

MIT
