Metadata-Version: 2.4
Name: agentforge-reranker-cohere
Version: 0.2.3
Summary: Cohere managed-API reranker for AgentForge
Project-URL: Homepage, https://github.com/Scaffoldic/agentforge-py
Project-URL: Repository, https://github.com/Scaffoldic/agentforge-py
Project-URL: Changelog, https://github.com/Scaffoldic/agentforge-py/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/Scaffoldic/agentforge-py/issues
Author: The AgentForge Authors
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agent,ai,cohere,rag,rerank
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: >=3.13
Requires-Dist: agentforge-core~=0.2.3
Provides-Extra: cohere
Requires-Dist: cohere>=5.0; extra == 'cohere'
Description-Content-Type: text/markdown

# agentforge-reranker-cohere

Cohere managed-API reranker for the AgentForge framework.

Implements the `Reranker` ABC from `agentforge-core`.
Registers as `agentforge.rerankers:cohere`.

## Installation

```bash
pip install agentforge-reranker-cohere[cohere]
```

## Usage

```python
from agentforge_reranker_cohere import CohereReranker

reranker = CohereReranker.from_config(
    api_key="...",
    model="rerank-english-v3.0",
)
```

Or via `agentforge.yaml`:

```yaml
retrieval:
  reranker:
    name: cohere
    config:
      api_key: ${COHERE_API_KEY}
      model: rerank-english-v3.0
```

The reranker forwards `(query, candidate_text)` pairs to
Cohere's Rerank API, normalises the returned scores to
`[0, 1]` (Cohere already does this — the clamp is
defensive), sorts descending, and truncates to `top_k`.

## License

Apache-2.0.
