Platform

Hybrid semantic + keyword code search in Atlas (2026)

Updated 5 min read

Hybrid semantic + keyword code search in Atlas, also known as Axis, combines the precision of keyword matching with the conceptual understanding of semantic search to find relevant code. This capability works by indexing code using AST declarations and local Ollama embeddings, then fusing both retrieval methods through reciprocal rank fusion to deliver a single, highly relevant result set to the developer.

What is hybrid code search in Atlas?

Atlas, the terminal-native AI coding agent, provides Axis, the hybrid semantic and keyword code search, to help developers locate relevant code by both meaning and exact text. This powerful capability, available in 2026, fuses results into one unified ranking, ensuring comprehensive and precise code discovery within your codebase.

Axis, the hybrid semantic and keyword code search, is a core retrieval capability within Atlas. It is designed to overcome the limitations of traditional keyword-only search, which can miss conceptually related code, and pure semantic search, which might overlook exact string matches. Atlas achieves this by performing both types of retrieval and then intelligently combining their outputs. This ensures that whether a developer is looking for a specific function name or a piece of code that performs a particular task, Atlas can surface the most relevant results.

What is reciprocal rank fusion in Atlas?

Reciprocal rank fusion is the critical algorithm Atlas uses to combine the results from its semantic and keyword code searches into a single, coherent ranking. This fusion process ensures that highly ranked items from either search method receive appropriate weight, providing a robust and comprehensive result set for developers in 2026.

Reciprocal rank fusion is the specific technique Atlas employs to merge the independent rankings generated by its semantic and keyword search components. When a developer initiates a search, Atlas first executes a semantic search, which identifies code based on its conceptual meaning, and a keyword search, which finds exact text matches. Each search produces a ranked list of results. Reciprocal rank fusion then takes these two lists and assigns a score to each unique item based on its rank in both lists. Items that appear high in both rankings receive a significantly boosted score, while items that appear high in only one still contribute meaningfully to the final combined ranking. This method is implemented in Atlas-Backend/atlas/src/codebase-index/domain/vector-math.ts and Atlas-Backend/atlas/src/codebase-index/application/search-engine.ts, specifically within the `reciprocalRankFusion` and `SearchEngine.search` symbols.

Frequently asked questions

What is Axis, the hybrid semantic and keyword code search?
Axis is Atlas's capability that finds code by both its meaning (semantic search) and exact text (keyword search), fusing these results into one comprehensive ranking using reciprocal rank fusion.
How does Atlas ensure my code is private during search?
Atlas ensures code privacy by building its code index with local Ollama embeddings. This means all semantic processing of your code happens on your machine, preventing your code from being sent to third-party servers.
What is reciprocal rank fusion and why does Atlas use it?
Reciprocal rank fusion is an algorithm Atlas uses to combine the ranked lists from its semantic and keyword searches. It ensures that highly relevant results from either method contribute significantly to the final unified ranking, providing a more robust and complete search outcome.
Does Atlas search all file types with its hybrid method?
Atlas indexes code by AST declarations using tree-sitter. While it excels at code files, its semantic search is optimized for structured code elements rather than arbitrary text files or comments not tied to declarations.
Where can I find the implementation details for Atlas's search?
The implementation for Atlas's hybrid search, including reciprocal rank fusion and the search engine, is located in the Atlas-Backend, specifically within the `atlas/src/codebase-index/domain/vector-math.ts` and `atlas/src/codebase-index/application/search-engine.ts` files.
Can I use different embedding models with Atlas's search?
Atlas builds its code index with local Ollama embeddings, allowing you to leverage local models. Atlas also lets you switch the active model and provider on the fly with favorites and recents, which applies to its agent interactions and potentially its embedding generation, depending on configuration.

Try SeaShell in your terminal

The terminal-native AI coding agent. Free core, single binary.

Install SeaShell

Related guides

Atlas with Ollama Cloud in 2026: direct Scaling for Your AI Coding Agent

In 2026, drive Atlas with Ollama Cloud for direct scaling of open-weights models. Access massive context windows up to 1,048,576 tokens and powerful models like qwen3-coder:480b, maintaining local Ollama continuity.

Atlas with Qwen3.7 Max in 2026

Explore Atlas with Qwen3.7 Max, Alibaba's 2026 flagship model. Leverage its 1M token context window and competitive pricing for advanced terminal-native AI coding tasks, offering a powerful and cost-effective solution.

Atlas with Mistral Large 3 (2512) in 2026

In 2026, Atlas developers can leverage Mistral Large 3 (2512) for extensive code generation and large unified diffs. With a 262,144 token context window and competitive pricing, it's ideal for substantial code

Atlas with Gemini 3.1 Flash Lite in 2026

Explore Gemini 3.1 Flash Lite for Atlas in 2026. This model offers a 1M token context at $0.25/Mtok input, making it ideal for large code indexes and planning agent tasks.

Atlas with Command R 35B (Ollama) in 2026

Explore Atlas with Command R 35B (Ollama) in 2026. This free, self-hosted model offers a 128K context window, excelling at RAG and tool use for your terminal-native AI coding agent.

Atlas for TensorFlow: Terminal-Native AI Coding for Keras 3 and tf.data in 2026

Atlas is a terminal-native AI coding agent for TensorFlow and Keras 3 in 2026, where tf.function graph tracing and tf.data pipelines are what make training fast.

Atlas vs Devin: Terminal AI Coding Agents in 2026

Atlas and Devin offer distinct approaches to AI coding in 2026. Compare their terminal-native TUI, sandboxed VMs, pricing, and code safety features.

Atlas with Mistral Small 3.2 (local via Ollama) in 2026

Explore Atlas with Mistral Small 3.2 (local via Ollama) for a powerful, self-hosted AI coding agent. Enjoy a 128,000 token context window and robust function calling, keeping your code local and free.

Browse this resource hub