vera-ai

Code search for AI agents. Vera indexes your codebase using tree-sitter parsing and hybrid search (BM25 + vector similarity + optional cross-encoder reranking), then returns ranked code snippets as Markdown codeblocks by default, or JSON with --json.

This package downloads and wraps the native Vera binary for your platform. On musl-based Linux (Alpine, NixOS), the correct static binary is selected automatically. Set VERA_TARGET to override target detection (e.g., VERA_TARGET=x86_64-unknown-linux-musl uvx vera-ai install).

The default local embedding model is minishlab/potion-code-16M-v2. It runs locally on CPU on any supported machine; no GPU or ONNX Runtime needed. In the 2026-08-23 Semble comparison, Vera scored 0.8441 nDCG@10 versus Semble 0.5.5 at 0.8514, using the same embeddings, harness, graded relevance, and suffix-corrected path matching. Full details live in the main repo docs.

Install

pip install vera-ai

Quick Start

vera-ai setup --potion-code --index .
vera-ai search "authentication logic"

vera-ai setup with no flags runs an interactive wizard and offers to index the current project, defaulting to yes. An interactive search also offers to create a missing index. vera-ai setup --api prompts for an OpenAI-compatible endpoint and key; use --yes with EMBEDDING_MODEL_* variables for non-interactive setup. vera-ai agent install manages skill files for your coding agents and can update AGENTS.md / CLAUDE.md style project instructions.

Common Tasks

Task Command
Use the interactive setup wizard vera-ai setup
Use the default local model vera-ai setup --potion-code
Configure API mode vera-ai setup --api
Use a local NVIDIA backend vera-ai setup --onnx-jina-cuda
Search semantically vera-ai search "authentication middleware"
Search only changed files vera-ai search "authentication middleware" --changed
Common structural tasks vera-ai structural routes / vera-ai structural env DATABASE_URL / vera-ai structural impls Loader
Find callers or callees vera-ai references foo / vera-ai references foo --callees
Explain why a file is missing vera-ai explain-path path/to/file
Inspect index health vera-ai stats --json
Keep the index up to date vera-ai update .
Watch for file changes vera-ai watch .
Run local HTTP inference server vera-ai serve
Diagnose setup issues vera-ai doctor
Run the deeper local probe vera-ai doctor --probe
Repair missing local assets vera-ai repair
Inspect binary upgrades vera-ai upgrade
Install agent skills vera-ai agent install

For the full backend matrix, model options, Docker setup, and troubleshooting, see the main README and Installation Guide.

What you get

  • 61+ languages via tree-sitter AST parsing
  • Hybrid search: BM25 keyword + vector similarity, fused with Reciprocal Rank Fusion
  • Opt-in cross-encoder reranking for precision, disabled by default
  • Git-aware scopes and index debugging: --changed / --since / --base, explain-path, and index health in vera-ai stats
  • Markdown codeblock output by default with file paths, line ranges, and optional symbol info (use --json for compact JSON; --raw works with vera-ai search, vera-ai grep, and vera-ai references; --timing works with vera-ai search and vera-ai grep, before or after the subcommand)

For full documentation, including local model options and manual install steps, see the GitHub repo.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.4.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for lemon07r from gravatar.com lemon07r

Credits

Author: VeraTools

License

MIT

Requires

Python >=3.9

Tags

vera cli code-search agents

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vera_ai-1.2.0.tar.gz (6.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vera_ai-1.2.0-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file vera_ai-1.2.0.tar.gz.

File metadata

  • Download URL: vera_ai-1.2.0.tar.gz
  • Upload date:
  • Size: 6.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.11.14

File hashes

Hashes for vera_ai-1.2.0.tar.gz
Algorithm Hash digest
SHA256 46f787f944d833c220afaa15a6e94a13a8ed22a98300ccf74f392ddf425bb406
MD5 ca188ea18a7e6ad459e9c67a87cde06d
BLAKE2b-256 48041212d3d36e7eeea48f4dda93979a65665de5f254bfd40e7b5eaf476eda11

See more details on using hashes here.

File details

Details for the file vera_ai-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: vera_ai-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 6.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.11.14

File hashes

Hashes for vera_ai-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b61fb5c0f848c6ac17ea47ad94b265ce333ebfb99e912414a5f80cb3e5019695
MD5 3f71598b465fbab44a6322198718c868
BLAKE2b-256 304e02d33bc3a8fd6abe6ba43f698b1cf93cfe6fb10a52a973b01731e5754794

See more details on using hashes here.

Release history Release notifications | RSS feed

1.4.0

2 files

1.3.1

2 files

1.3.0

2 files

This release

1.2.0 This release

2 files

1.1.0

2 files

1.0.1

2 files

1.0.0

2 files

0.12.13

2 files

0.12.12

2 files

0.12.11

2 files

0.12.10

2 files

0.12.9

2 files

0.12.8

2 files

0.12.7

2 files

0.12.6

2 files

0.12.5

2 files

0.12.4

2 files

0.12.3

2 files

0.12.2

2 files

0.12.0

2 files

0.11.7

2 files

0.11.6

2 files

0.11.5

2 files

0.11.3

2 files

0.11.2

2 files

0.11.1

2 files

0.11.0

2 files

0.10.3

2 files

0.10.2

2 files

0.10.1

2 files

0.10.0

2 files

0.9.21

2 files

0.9.20

2 files

0.9.19

2 files

0.9.18

2 files

0.9.17

2 files

0.9.16

2 files

0.9.15

2 files

0.9.14

2 files

0.9.13

2 files

0.9.12

2 files

0.9.11

2 files

0.9.10

2 files

0.9.9

2 files

0.9.8

2 files

0.9.7

2 files

0.9.6

2 files

0.9.5

2 files

0.9.4

2 files

0.9.3

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

0.8.4

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.0

2 files

0.6.0

2 files

0.5.0

2 files

0.4.1

2 files

0.4.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

0.1.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page