Veles
Fast, hybrid (BM25 + semantic) local code search for AI agents and humans, written in pure Rust.
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirVeles runs entirely on CPU — no GPU, no transformer forward pass at query time. Queries return in tens of milliseconds against a persistent on-disk index, with tree-sitter-aware symbol lookups, pipe-friendly output formats, and built-in MCP / gRPC servers for integration with Claude, Cursor, or anything else that speaks JSON-RPC. Static embeddings come from the potion family via model2vec-rs.
Originally inspired by Semble — Veles started as a Rust port of the same hybrid retrieval recipe and has grown to add persistent + incremental indexing, tree-sitter symbols / defs / refs, six pipe-friendly output formats, glob/language filters, gRPC, and shell completions.
veles search "query" ./my-repoIndex, Search, FindRelated, GetStats RPCs<repo>/.veles/ — searches reuse the cache and finish in tens of milliseconds. Incremental update keeps embeddings of unchanged files.symbols / defs / refs for Rust, Python, JavaScript, TypeScript, Godefines `Foo` or in `bar` suffix so the result header alone tells you what each chunk ispretty, compact, ripgrep, paths, json, jsonl--lang, --path and --exclude glob patterns, --min-score# Linux / macOS — prebuilt binary (one-liner)
curl --proto '=https' --tlsv1.2 -LsSf \
https://github.com/julymetodiev/Veles/releases/latest/download/veles-cli-installer.sh | sh
# Windows — PowerShell
irm https://github.com/julymetodiev/Veles/releases/latest/download/veles-cli-installer.ps1 | iex
# Homebrew (macOS / Linux)
brew install julymetodiev/tap/veles-cli
# From crates.io (compiles locally; no protoc / extra deps needed)
cargo install veles-cli
# Manual download
gh release download --repo julymetodiev/Veles --pattern '*linux-gnu*' # or browse
# https://github.com/julymetodiev/Veles/releases/latest
# Verify (optional)
veles --version # → veles 0.6.0
See INSTALL.md for SHA-256 verification and other install paths.
veles index . # one-off, builds .veles/
veles search "parse config file" # auto-loads the cache
veles update . # refresh after edits
The first search downloads the embedding model from Hugging Face (~64 MB, cached at ~/.cache/huggingface/hub/).
veles search "rate limiting" # hybrid (default)
veles search "rate limiting" -t 10 -f compact # 10 results, 1 line each
veles search "rate limiting" -f rg # ripgrep-style path:line:content
veles search "rate limiting" -f json | jq '.results' # structured for scripting
veles search "rate limiting" -f paths | xargs $EDITOR # open every matching file
veles search "TokenStream" -m bm25 # exact identifier
veles search "auth flow" -m semantic # fuzzy concept
veles search "auth" -l rust,python # language filter
veles search "X" -g 'src/**/*.rs' -x 'src/legacy/**' # glob include / exclude
veles search "BM25" --min-score 0.4 # drop weak hits
veles symbols crates/veles-core/src/persist.rs # outline a single file
veles defs Manifest # every definition named "Manifest"
veles defs save -k function -l rust # filter by kind + language
veles refs save_index -t 30 # defs + BM25 references
veles find-related src/main.rs 42 # semantically similar chunks
veles find-related src/main.rs 42 -l rust # restrict to one language
veles find-related src/main.rs 42 -g 'crates/foo/**' # restrict to a subtree
veles index . # bootstrap
veles index . --force # rebuild from scratch
veles update . # incremental refresh
veles status . # manifest + drift
veles clean . # remove .veles/
veles tui # live hybrid search with preview pane
veles tui ./my-repo # against another repo
veles tui --debug-keys # echo every keypress (terminal diagnostic)
Loads the persistent index once, then debounces queries so each keystroke re-runs in tens of milliseconds. Highlights:
↑↓ navigate, Tab cycles hybrid/bm25/semantic.Ctrl-D defs, Ctrl-F refs, Ctrl-R semantically related.
With an empty query, Ctrl-D / Ctrl-F use the selected row's symbol.Ctrl-B / Ctrl-X (also F2/F3, Alt-←/→, Alt-h/l)
jump back and forward across past views — like a browser.Ctrl-↑ / Ctrl-↓ (also Alt-P/Alt-N) walk past
queries, recorded at Enter, Ctrl-O, Ctrl-R/D/F, and Ctrl-U.Ctrl-T cycles language filter through the indexed
languages, Ctrl-Y opens a path-glob input. Both pass through to
every dispatch (search, related, defs, refs).Shift-↑↓ / Shift-PgUp/PgDn scroll within the chunk;
F5–F8 are non-modifier fallbacks for terminals that swallow Shift+Arrow.Enter prints path:line to stdout ($EDITOR $(veles tui)
works), Ctrl-O spawns $EDITOR in-place and returns to the TUI on
exit. Editor heuristic covers vim / nvim / emacs / nano / VS Code /
Cursor / Windsurf / Helix; set $EDITOR=vim (or $VISUAL) to pick.? (when the query is empty) opens a scrollable keybinding
overlay; Ctrl-G cancels an in-flight search (readline convention);
Esc / Ctrl-C quit.veles serve-mcp # MCP over stdio (default if no args)
veles serve-grpc --addr "[::1]:50051" # gRPC
mkdir -p ~/.zfunc ~/.local/share/man/man1
veles completions zsh > ~/.zfunc/_veles
veles man --out-dir ~/.local/share/man/man1
veles man --out-dir DIR writes one page per subcommand (veles.1,
veles-search.1, veles-defs.1, …) so man veles-search works the
same way as man git-commit.
Then once in ~/.zshrc:
fpath=(~/.zfunc $fpath)
autoload -Uz compinit && compinit
export MANPATH="$HOME/.local/share/man:$MANPATH"
veles search "BM25 inverted index" https://github.com/julymetodiev/Veles
See USAGE.md for the full reference, recipes (fzf, vim quickfix, jq), and troubleshooting.
veles serve-mcp # explicit
veles # equivalent — bare `veles` starts MCP when stdin is piped
Exposed tools:
search, find_related, and refs accept a format argument:
default (default) — scored, fenced code blocks tagged with the enclosing scope.paths — flat per-line list. search / find_related emit path:start-end; refs emits path:line per word-boundary occurrence of the symbol.unique_paths — collapsed to one path line per file. For agent shortlist workflows that just want "which files matter".cargo build --release
tonic-build ships a vendored protoc via protoc-bin-vendored, so no system-wide protobuf compiler is required.
The workspace publishes four crates on crates.io — pick the layer you need:
Full API docs are on docs.rs.
[dependencies]
veles-core = "0.2"
use std::path::Path;
use veles_core::{SearchMode, VelesIndex};
let index = VelesIndex::from_path(Path::new("."), None, None, false)?;
let results = index.search("parse config", 5, SearchMode::Hybrid, None, None, None);
for r in results {
println!("{} [{:.3}]", r.chunk.location(), r.score);
}
# Ok::<(), anyhow::Error>(())
Veles/
crates/
veles-core/ indexing, chunking, BM25, dense search, ranking, symbols
veles-grpc/ gRPC service (tonic + prost)
proto/
veles.proto gRPC schema
veles-mcp/ MCP server over stdio
veles-cli/ CLI binary
The persistent index lives under <repo>/.veles/:
.veles/
manifest.json # model, dim, per-file (size, mtime, chunk_count)
chunks.bin # bincode Vec<Chunk>
bm25.bin # bincode BM25 inverted index
dense.bin # bincode dense matrix
symbols.bin # bincode tree-sitter symbols
update reuses embeddings of files whose (size, mtime) fingerprint hasn't changed, so refreshing after a small edit is near-instant on large repos.
MIT
Fast hybrid (BM25 + semantic) local code search for AI agents - pure Rust, persistent index, MCP/gRPC servers, tree-sitter symbols
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Veles roda localmente via stdio.
Última verificação: 2026-10-28. Fast hybrid (BM25 + semantic) local code search for AI agents - pure Rust, persistent index, MCP/gRPC servers, tree-sitter symbols