flatseek 0.1.2

Scalable engine to ingest, process, and query large datasets—transactions, logs, events, and analytics—directly from flat files.

Flatseek

Full text search over flat files. No JVM. No cluster. No ops burden.

Search, filter, and aggregate CSV/JSON visually — no setup required.

Demo: flatlens.demo.flatseek.io  ·  Docs: flatseek.io/docs  ·  Benchmark: flatbench

---

Why Flatseek

• Correct always. Every query returns exact counts. No silent wrong results.
• Single binary. No JVM, no cluster config, no heap tuning.
• Fast enough. p50 2.2ms handles production traffic.
• Embed or serve. Use as a library or run as a sidecar API.

---

Performance

500K rows, article schema, SSD. Flatseek is 2× faster on search than Elasticsearch with exact counts where others silently miss.

Metric	Flatseek	Elasticsearch
Search p50	7.9ms	16.1ms
Range query hits	501,011 (exact)	505,044
Build 500K rows	216s	113s

Full comparison (tantivy, typesense, whoosh, zincsearch): bench.flatseek.io

---

Quick Start

# 1. Install
curl -fsSL flatseek.io/install.sh | sh

# 2. Build index
flatseek build ./data.csv -o ./data

# 3. Serve API + dashboard
flatseek serve -d ./data
# → API:       http://localhost:8000
# → Dashboard: http://localhost:8000/dashboard

# 4. Query
flatseek search ./data "program:raydium AND amount:>1000000"

No config files. No cluster.

---

Core Capabilities

• Full text search — tokenized, trigram-backed wildcard (*kube*)
• Range queries — exact counts on numeric, date, keyword fields
• Aggregations — terms, stats, min/max, cardinality, date histogram
• Array fields — matches any element (tags:graphql)
• Nested objects — dot-path queries (address.city:Jakarta)
• Boolean operators — AND, OR, NOT with grouping
• Encryption at rest — ChaCha20-Poly1305
• Parallel indexing — multi-worker builds

See docs/ for full details.

---

Docs

Guide	Description
Quick Start	Install, index, query — in 5 minutes
Indexing	Formats, column types, parallel builds, encrypt
Query Language	Full syntax reference
Aggregation	Aggregation types and examples
CLI Reference	All CLI commands
REST API	API endpoints
Architecture	How Flatseek stores and queries data

---

Install

Recommended — one-liner

curl -fsSL flatseek.io/install.sh | sh

Includes API server + Flatlens dashboard (http://localhost:8000/dashboard).

PyPI

pip install flatseek

CLI only. For Flatlens dashboard: git clone https://github.com/flatseek/flatlens

From source

git clone https://github.com/flatseek/flatseek.git
cd flatseek && pip install -e .

Requirements: Python ≥ 3.10, macOS / Linux / WSL.

---

Contributing

PRs welcome. Run tests:

pytest src/flatseek/test/test_search.py -v   # accuracy tests (~110 cases)
pytest src/flatseek/test/test_api.py         # API smoke tests
pytest src/flatseek/test/test_cli.py          # CLI integration

---

License

Apache 2.0. See LICENSE.