Metadata-Version: 2.4
Name: vera-ai
Version: 0.9.5
Summary: Bootstrap installer and wrapper for the Vera CLI
Author: lemon07r
License: MIT
Project-URL: Homepage, https://github.com/lemon07r/Vera#readme
Project-URL: Repository, https://github.com/lemon07r/Vera
Project-URL: Issues, https://github.com/lemon07r/Vera/issues
Keywords: vera,cli,code-search,agents
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# 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.7.0` reaches `0.78` Recall@5, `0.83` Recall@10, `0.91` MRR@10, and `0.84` 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/CoreML/OpenVINO)
vera-ai index . --onnx-jina-cuda

# Diagnose or repair local setup issues
vera-ai doctor
vera-ai doctor --probe
vera-ai repair
vera-ai upgrade
```

`vera-ai doctor --probe` runs a deeper read-only ONNX session check. `vera-ai upgrade` shows the binary update plan and can apply it when the install method is known.

## 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
- **Markdown codeblock output** by default with file paths, line ranges, and optional symbol info (use `--json` for compact JSON, `--raw` for verbose output, `--timing` for step durations)

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