Veles
Fast, hybrid (BM25 + semantic) local code search for AI agents and humans, written in pure Rust.
Power your agent
Yayıncıdan kurulum. PlugMCP uç noktası değildir.
Host a copy with our keys and logs.
Registry'de henüz paketlenmiş bir sürüm yok. Deponun README dosyasını izleyin.
Uzak URL mi, yoksa makinenizde bir komut mu? İki kurulum arasındaki fark
PlugMCP’de çalıştır
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.
BaşlatVeles 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
Araçlar
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.
Veles yerel olarak stdio üzerinden çalışır.
Son kontrol: 2026-10-28. Fast hybrid (BM25 + semantic) local code search for AI agents - pure Rust, persistent index, MCP/gRPC servers, tree-sitter symbols