Metadata-Version: 2.5
Name: vf-hive-serve
Version: 0.8.0
Summary: Serve + test OKF concept cards as agent context (no RAG)
Project-URL: Homepage, https://github.com/voyagerforge-dev/hive-intelligence
Project-URL: Documentation, https://github.com/voyagerforge-dev/hive-intelligence/blob/main/docs/reference/hive-serve.md
Project-URL: Source, https://github.com/voyagerforge-dev/hive-intelligence
Project-URL: Issues, https://github.com/voyagerforge-dev/hive-intelligence/issues
Project-URL: Release notes, https://github.com/voyagerforge-dev/hive-intelligence/releases
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Software Development :: Documentation
Requires-Python: >=3.12
Requires-Dist: fastapi>=0.135
Requires-Dist: mcp==1.28.1
Requires-Dist: prometheus-client>=0.20
Requires-Dist: psycopg[binary]>=3.2
Requires-Dist: pydantic-settings>=2.5
Requires-Dist: pydantic>=2.9
Requires-Dist: pyyaml>=6.0
Requires-Dist: uvicorn>=0.30
Requires-Dist: vf-hive-gen==0.8.0
Provides-Extra: dev
Requires-Dist: httpx>=0.27; extra == 'dev'
Requires-Dist: pytest>=8.3; extra == 'dev'
Requires-Dist: ruff>=0.7; extra == 'dev'
Provides-Extra: semantic
Requires-Dist: httpx>=0.27; extra == 'semantic'
Description-Content-Type: text/markdown

# hive-serve

Serves cards over REST and MCP, with a per-person work ledger. Stage 3. Calls no model.

[![PyPI](https://img.shields.io/pypi/v/vf-hive-serve.svg)](https://pypi.org/project/vf-hive-serve/)
[![Licence: Apache 2.0](https://img.shields.io/badge/licence-Apache--2.0-blue.svg)](https://github.com/voyagerforge-dev/hive-intelligence/blob/main/LICENSE)

Part of [Hive Intelligence](https://github.com/voyagerforge-dev/hive-intelligence), which turns a body of documentation into
reviewed, git-versioned concept cards and serves them to any MCP or REST client - no vector
index, no embeddings, and no model call at serving time.

**Full documentation: [docs/reference/hive-serve.md](https://github.com/voyagerforge-dev/hive-intelligence/blob/main/docs/reference/hive-serve.md)**, which covers the command
surface, configuration, behaviour and the things that catch people out.

## Install

```bash
pip install vf-hive-serve
hiveserve serve --help
```

`hiveserve serve` needs a corpus (`CONCEPTS_DIR`) and, under its default tool profile, a
Postgres ledger (`LEDGER_DSN`), and refuses to start without them. [Getting started](https://github.com/voyagerforge-dev/hive-intelligence/blob/main/docs/guides/getting-started.md)
walks the whole thing from a clean checkout in about five minutes.

## From source

```bash
cd tooling/hive-serve
uv sync --extra dev     # install
uv run pytest -q        # test
uv run hiveserve serve --http
```

This file is deliberately short. Everything else lives in the reference doc, so there is one
place to keep current rather than two that drift apart.
