# vera-ai

Code search for AI agents. Vera indexes your codebase using tree-sitter parsing and hybrid search (BM25 + vector similarity + cross-encoder reranking), then returns ranked code snippets as structured JSON.

This package downloads and wraps the native Vera binary for your platform.

Current benchmark snapshot: on Vera's local 21-task, 4-repo release benchmark, `v0.6.0` reaches `1.0` Recall@5, `1.0` Recall@10, `1.0` MRR@10, and `0.9832` nDCG@10 with the local Jina CUDA ONNX stack. Full details live in the main repo docs.

## Install

```bash
pip install vera-ai
```

## Usage

```bash
# Index a project
vera-ai index .

# Search
vera-ai search "authentication middleware"

# Local ONNX inference (no API keys needed. downloads models automatically)
vera-ai index . --onnx-jina-cpu
vera-ai search "error handling" --onnx-jina-cpu

# GPU acceleration (NVIDIA/AMD/DirectML)
vera-ai index . --onnx-jina-cuda
```

## What you get

- **60+ languages** via tree-sitter AST parsing
- **Hybrid search**: BM25 keyword + vector similarity, fused with Reciprocal Rank Fusion
- **Cross-encoder reranking** for precision
- **JSON output** with file paths, line ranges, code content, and relevance scores

For full documentation, see the [GitHub repo](https://github.com/lemon07r/Vera).
