Metadata-Version: 2.4
Name: nvhive
Version: 0.42.0
Summary: NVHive — Multi-LLM orchestration platform with intelligent routing, hive consensus, and auto-agent generation
Author: thatcooperguy and nvHive Contributors
Maintainer: thatcooperguy
License-Expression: PolyForm-Noncommercial-1.0.0
Project-URL: Homepage, https://github.com/thatcooperguy/nvHive
Project-URL: Repository, https://github.com/thatcooperguy/nvHive
Project-URL: Issues, https://github.com/thatcooperguy/nvHive/issues
Project-URL: Documentation, https://github.com/thatcooperguy/nvHive/tree/main/docs
Project-URL: Source, https://github.com/thatcooperguy/nvHive
Project-URL: Changelog, https://github.com/thatcooperguy/nvHive/blob/main/CHANGELOG.md
Project-URL: Trademark Policy, https://github.com/thatcooperguy/nvHive/blob/main/TRADEMARKS.md
Keywords: llm,ai,nvidia,gpu,orchestration,multi-model,agents,ollama,nemotron
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: GPU :: NVIDIA CUDA
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE.md
Requires-Dist: typer>=0.12
Requires-Dist: litellm>=1.99
Requires-Dist: pydantic>=2.0
Requires-Dist: sqlalchemy[asyncio]>=2.0
Requires-Dist: aiosqlite>=0.20
Requires-Dist: keyring>=25.0
Requires-Dist: rich>=13.0
Requires-Dist: httpx>=0.27
Requires-Dist: pyyaml>=6.0
Requires-Dist: tiktoken>=0.7
Requires-Dist: anyio>=4.0
Requires-Dist: zstandard>=0.20
Requires-Dist: packaging>=23
Provides-Extra: serve
Requires-Dist: fastapi>=0.100; extra == "serve"
Requires-Dist: uvicorn[standard]>=0.20; extra == "serve"
Requires-Dist: passlib[bcrypt]>=1.7; extra == "serve"
Requires-Dist: python-multipart>=0.0.6; extra == "serve"
Provides-Extra: nvidia
Requires-Dist: nvidia-ml-py3>=7.352.0; extra == "nvidia"
Provides-Extra: mcp
Requires-Dist: mcp[cli]<2,>=1.0; extra == "mcp"
Provides-Extra: vision
Requires-Dist: pyautogui>=0.9.54; extra == "vision"
Requires-Dist: python-xlib>=0.33; sys_platform == "linux" and extra == "vision"
Requires-Dist: Pillow>=10.0; extra == "vision"
Provides-Extra: browser
Requires-Dist: playwright>=1.40; extra == "browser"
Provides-Extra: rag
Requires-Dist: pypdf>=4.0; extra == "rag"
Provides-Extra: jupyter
Requires-Dist: ipython>=8; extra == "jupyter"
Provides-Extra: all
Requires-Dist: nvhive[browser,jupyter,mcp,nvidia,rag,serve,vision]; extra == "all"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: pytest-timeout>=2.3; extra == "dev"
Requires-Dist: ruff>=0.4; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Requires-Dist: nvhive[mcp,nvidia,rag,serve]; extra == "dev"
Dynamic: license-file

<div align="center">

# nvHive

**One curl command turns a rented Linux GPU desktop into a working AI lab.**

No root. No Docker. Survives reconnects.

[![PyPI](https://img.shields.io/pypi/v/nvhive)](https://pypi.org/project/nvhive/)
[![License: PolyForm NC](https://img.shields.io/badge/license-PolyForm%20Noncommercial-blue)](LICENSE)
[![CI](https://github.com/thatcooperguy/nvHive/actions/workflows/ci.yml/badge.svg)](https://github.com/thatcooperguy/nvHive/actions/workflows/ci.yml)

</div>

```bash
curl -sSL https://raw.githubusercontent.com/thatcooperguy/nvHive/main/install.sh | bash
```

Works on any rented NVIDIA GPU desktop — RunPod, Lambda, Vast, … — anywhere you can open a terminal on an NVIDIA machine. A few minutes later your browser opens on a dashboard where everything already works:

- **A local LLM picked for your GPU's VRAM** — chat and image understanding with nothing leaving the machine
- **An AI Wizard that knows your workspace** — reads live GPU/service state, fixes problems, RAGs over your files, searches the web
- **A router across local and cloud providers** — free tiers first when you have no keys, your GPU first when you do
- **Storage that survives resets** — models, chats, and config live on the persistent volume

The browser only opens after every service passes a health check — including a real end-to-end test where the Wizard answers a message. You pay for GPU time, not debugging time.

![Model Manager — every model shows whether it fits your GPU before you download](docs/screenshots/model-manager.png)

## What's inside

**Model Manager.** nvHive detected your GPU at install, so every model in the catalog shows a *fits-your-GPU* verdict and disk size **before** you download. One-click install with live progress, or `nvh models pull gemma3:4b` from the terminal. [Guide →](docs/MODELS.md)

**AI Wizard.** A streaming, tool-using assistant grounded in live workspace state. It can refresh models, run safe repairs, ingest files you drag into chat (PDFs included), and cite web sources — showing cost and latency per response. Attach external [MCP tool servers](docs/INTEGRATIONS.md#nvhive-as-an-mcp-client) and their tools join its toolset.

**Agent Library and council mode.** 100 agent profiles across 38 categories — coding, research, creative, GPU media, ops — each mappable to a local or cloud model. Council mode runs one question through multiple models in parallel and synthesizes the answers: `nvh convene "Redis or Postgres for session storage?"`. [Cabinets →](docs/CONFIGURATION.md#council-cabinets)

![Agent Library — 100 built-in agent profiles](docs/screenshots/agent-library.png)

**Chat history that survives.** Conversations persist server-side, browsable and resumable from every page. Pin one and it's waiting for you after a reconnect.

**Studio packs.** Rootless one-command installs for ComfyUI, Blender, game-dev tooling, and music production: `nvh studio --install comfy -y`.

**Built for machines that disappear.** Everything lives under `NVH_HOME` on the persistent volume. Downloads run as resumable jobs. `nvh snapshot save` / `restore` moves your whole state to a brand-new VM. If your persistent mount isn't auto-detected: `export NVH_HOME=/mnt/persist/nvhive` before installing.

## Requirements

- **Linux x86_64** (primary target; Windows/macOS binaries on the [Releases page](https://github.com/thatcooperguy/nvHive/releases/latest))
- **No root, no Docker** — everything installs to user-owned paths
- **Python 3.11+**, or none at all (`NVH_USE_BINARY=1` with `start-linux.sh` fetches a single-file binary)
- **GPU optional** — CPU-only machines get a small local model plus cloud free tiers
- **Disk** — ~2 GB for the smallest local model; the installer shows sizes and checks free space before downloading

Already have Python? `pip install nvhive` (extras: `[vision]`, `[rag]`, `[all]`).

## If something breaks

```bash
nvh services             # per-service health table
nvh services restart     # recycle the stack
nvh status --deep        # full diagnostic
```

The dashboard's **Debug Report** button generates a redacted report (secrets stripped) you can paste straight into an issue. Logs live under `$NVH_HOME/logs/`.

## Commands

| Command | What it does |
|---|---|
| `nvh "question"` | Route to the best available model |
| `nvh ask "question" --local` | Local inference only — nothing leaves the machine |
| `nvh convene "question"` | Multi-model council with synthesis |
| `nvh agent run "task"` | Agentic coding with review loop |
| `nvh models list --all` | Fit-ranked model catalog for your GPU |
| `nvh services start` | Verified bring-up (Ollama → API → WebUI → smoke test) |
| `nvh studio --install <pack> -y` | Rootless tool-pack install |
| `nvh snapshot save` / `restore` | Move state across ephemeral VMs |
| `nvh setup` | Configure providers and keys |

Full reference: [docs/COMMANDS.md](docs/COMMANDS.md)

## Documentation

| Guide | What's inside |
|---|---|
| [Getting Started](docs/GETTING_STARTED.md) | Install, first five minutes, hardware, running without root, studio packs, troubleshooting |
| [Models](docs/MODELS.md) | Model Manager, GPU detection, VRAM tiers, capability matrix, `nvh bench` |
| [Providers](docs/PROVIDERS.md) | Every provider, key variable, free tier and default model |
| [Commands](docs/COMMANDS.md) | Generated CLI reference |
| [Configuration](docs/CONFIGURATION.md) | `config.yaml`, env vars, `NVH_HOME` layout, `HIVE.md`, cabinets, tools, workflows |
| [Web UI](docs/WEBUI.md) | The dashboard, page by page |
| [Integrations](docs/INTEGRATIONS.md) | Python SDK, REST, OpenAI/Anthropic proxies, MCP, Claude Code, NemoClaw, OpenClaw, VS Code |
| [Architecture](docs/ARCHITECTURE.md) | Request flow, modules, persistence |
| [Testing](docs/TESTING.md) | Running and writing tests, CI |
| [Maintainers](docs/MAINTAINERS.md) | Releasing, service order, production readiness |
| [Roadmap](docs/ROADMAP.md) | Plan by release, feature table, non-goals |

## Notes

- Cloud providers receive the queries you route to them, under their own privacy policies. Use `nvh ask --local` to keep inference local.
- AI output can be wrong. Review agent-modified files before shipping them.

## License

**PolyForm Noncommercial 1.0.0** — use, modify, and share nvHive freely for any noncommercial purpose. **Selling this code or using it commercially is not permitted.** See [LICENSE](LICENSE) and [NOTICE](NOTICE.md). Versions 0.40.0 and earlier were released under MIT and remain MIT.

The license does not grant rights to the nvHive name or logos; forks should use distinct names. See [TRADEMARKS](TRADEMARKS.md).
