Open Fast Lookup (OFL)

A deterministic, low-latency search standard and reference implementation.

Built by XPDevs.

Features

• Deterministic, explainable search results
• Index-first architecture for sub-2ms hot queries
• Local-first, no remote dependencies
• No AI, no ML, no embeddings
• Structured SearchOutput contract
• Library, CLI, and daemon modes
• Filesystem metadata search
• Structured records search (JSON, NDJSON)
• Crash-safe index commits with SHA-256 checksums
• Multiple index types: exact, prefix, range, bitmap, trigram

Installation

git clone https://github.com/XPDevs/OFL.git
cd OFL
npm install

Quick Start

# Create a config file (ofl.json)
# Then build an index
ofl build --config ./ofl.json

# Search
ofl search --text "report" --json

# Run as daemon
ofl daemon start

Configuration

Create an ofl.json in your project root:

{
  "index_dir": ".ofl/index",
  "sources": [
    {
      "id": "my-files",
      "name": "My Files",
      "type": "filesystem-metadata",
      "root": "/path/to/search"
    }
  ],
  "security": {
    "follow_symlinks": false,
    "include_hidden": false,
    "max_depth": 50,
    "default_limit": 50
  }
}

CLI Commands

Command	Description
ofl search	Search indexed data
ofl build	Build or rebuild indexes
ofl verify	Verify index integrity
ofl info	Show source and index information
ofl daemon	Manage the local daemon
ofl bench	Run benchmarks
ofl conformance	Run conformance tests

Library Usage

import { createSearchOutput, normalizeQueryText, tokenizeText } from 'ofl';

Daemon

The daemon keeps indexes hot in memory and answers queries over a local Unix socket:

ofl daemon start
ofl daemon query --text "search term"
ofl daemon status
ofl daemon stop

Documentation

• Specification
• Architecture
• Query Model
• Output Model
• Benchmarks
• Security
• Design Decisions
• Contributing

Testing

npm test
npm run conformance
npm run bench

License

Apache-2.0 - see LICENSE

About

OFL is developed by XPDevs. It provides an open standard for deterministic, low-latency search over local files and structured records without relying on AI or remote services.