Pando

Pando is a C++ corpus query engine in the same family as Manatee and CWB/CQP: it supports familiar positional/s-attribute style querying, adds the ability to search over dependency trees, and has extensive support for aligned corpora. The repository currently focuses on:

• Core engine: query parsing, execution, and indexing (src/query, src/index, src/corpus).
• CLI tools: binaries for querying, indexing, checking, and serving HTTP APIs (src/cli, src/api).
• Dev tooling: internal benchmark harnesses and design notes under dev/ (not installed or shipped).

This README is intentionally minimal and documents how to build and run the current prototype for private/use-at-your-own-risk purposes.

Documentation: see wiki/Home.md for an overview, wiki/PANDO-CQL.md for the query language, and wiki/README.md for topic pages (same layout as flexipipe/flexiconv).

Status

• Scope: Internal / experimental. APIs, on-disk formats, and CLI flags may change without notice.
• Maturity: The engine and CLI are usable enough to run real benchmarks and experiments, but not yet ready for public release or long-term format stability guarantees.
• Companion repos: Pando is designed to work with flexicorp an corpus manager for the integration of TEITOK with corpus managers.

Prerequisites

• OS: Linux or macOS (development currently on macOS).
• Toolchain:
  • CMake (>= 3.16 recommended).
  • A C++17 (or newer) compiler (e.g. Clang, GCC).
  • Python 3.9+ for dev scripts and benchmarks.

All C++ library dependencies are pulled in via CMake (e.g. httplib vendored through add_subdirectory/FetchContent in CMakeLists.txt), so you typically do not need system-wide packages beyond a standard build toolchain.

Quick start: build

From the repository root:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(sysctl -n hw.ncpu 2>/dev/null || nproc || echo 4)

This should produce several binaries in build/, including:

• pando – main query CLI.
• pando-index – corpus indexing tool.
• pando-check – consistency / sanity checker.
• pando-server – HTTP/JSON API server (if enabled in CMake).

Exact binary names and options may evolve; run each with --help for the current CLI.

Running a simple query

For sample corpora (bundled CoNLL-U, JSONL fixture, and the full-UD download script), see wiki/Sample-Corpora.md.

Assuming you already have a Pando-formatted corpus at /path/to/corpus and have built the project:

./build/pando /path/to/corpus '[word="example"]' --count-only --timing

This should print total match count and timing information to stdout/stderr.

License

This repository is currently private and experimental. Choose and add a proper license (e.g. MIT, Apache 2.0) before making the project public or sharing it more broadly.