# golars

golars is a pure-Go DataFrame library modeled on polars, built on arrow-go. Eager and lazy execution, streaming engine, SIMD kernels, no cgo.

## Documentation

- [API design](/docs-md/api-design): golars borrows the shape of polars' API: polars-style expressions with Go naming conventions. This document records the conventions.
- [golars / polars API surface](/docs-md/api-surface): Map between polars' Python API and golars' Go surface.
- [Architecture overview](/docs-md/architecture): Layered query engine over Apache Arrow memory. Eager DataFrame + lazy LazyFrame facades share the same kernels.
- [Cookbook](/docs-md/cookbook): End-to-end recipes for common tasks. Every snippet compiles.
- [Getting Started](/docs-md/getting-started): Install golars, open the REPL, run a query.
- [Introduction](/docs-md/index): A pure-Go port of polars on top of arrow-go. Lazy plan, optimizer, streaming engine, SIMD kernels, no cgo.
- [MCP: golars as a tool for your LLM host](/docs-md/mcp): golars-mcp is a Model Context Protocol server that exposes a read-only subset of golars as tools any MCP host can invoke.
- [Memory model](/docs-md/memory-model): Buffer ownership, reference counting, allocator hooks, and how the Arrow/Go GC handoff works in hot kernels.
- [Parallelism model](/docs-md/parallelism): Goroutine + channel morsel-driven engine. Bounded parallelism, back-pressure, and order-preserving fan-out.
- [golars scripting language (.glr)](/docs-md/scripting): .glr files are a tiny, line-oriented language for pipeline-style DataFrame work. Every REPL command is a script statement.
- [SQL frontend](/docs-md/sql): SELECT / FROM / WHERE / GROUP BY / ORDER BY / LIMIT — compiles to the same lazy plan as the Go API.

## Reference

- [llms-full.txt](/llms-full.txt): every page concatenated for single-request ingestion.
- [GitHub](https://github.com/Gaurav-Gosain/golars): source, issues, releases.