[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-76351":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":13,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":13,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":15,"starSnapshotCount":15,"syncStatus":26,"lastSyncTime":27,"discoverSource":28},76351,"zenith","Polarityinc\u002Fzenith","Polarityinc","Zenith: AI-agent-trace database in Rust, Worlds fastest database for FTS, trace loading, attribute filtering and group by keyword","https:\u002F\u002Fzenith.polarity.so",null,"Rust",134,5,1,0,15,46.33,"Apache License 2.0",false,"main",true,[],"2026-06-11 04:06:43","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fzenith.polarity.so\">\n    \u003Cimg src=\".github\u002Fassets\u002Fzenith.png\" alt=\"ZenithDB\" width=\"100%\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>The columnar database purpose-built for AI agent traces.\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FPolarityinc\u002Fzenith\u002Factions\u002Fworkflows\u002Fci.yml\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FPolarityinc\u002Fzenith\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg\" alt=\"CI\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache%202.0-blue.svg\" alt=\"License: Apache 2.0\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FPolarityinc\u002Fzenith\u002Fblob\u002Fmain\u002Frust-toolchain.toml\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Frust-1.87%2B-orange.svg\" alt=\"Rust 1.87+\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"CHANGELOG.md\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fstatus-alpha-yellow.svg\" alt=\"Status: alpha\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FPolarityinc\u002Fzenith\u002Fissues\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FPolarityinc\u002Fzenith.svg\" alt=\"Issues\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"#quickstart\">Quickstart\u003C\u002Fa> ·\n  \u003Ca href=\"#architecture\">Architecture\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002FRUNBOOK.md\">Runbook\u003C\u002Fa> ·\n  \u003Ca href=\"CONTRIBUTING.md\">Contributing\u003C\u002Fa> ·\n  \u003Ca href=\"CHANGELOG.md\">Changelog\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\n## What is ZenithDB?\n\n**ZenithDB** is an open source, columnar database engine purpose-built for the AI agent observability workload — long, sparse, high-cardinality JSON traces with rich text fields, late-arriving annotations, and bursty ingest. It is written in Rust, exposes HTTP \u002F gRPC \u002F OTLP endpoints, and speaks both SQL and ZenithQL.\n\nExisting observability backends are built for short, structured spans and pay a 10–100× cost on this workload. ZenithDB's storage engine is built around five non-negotiable design choices that make AI traces cheap to store and fast to query:\n\n1. **PAX segment format** sorted by `(trace_id, start_time, span_id)`, with per-row offset directories on wide string columns.\n2. **Trace-locality at compaction time** — every span of a trace lands in one row group.\n3. **Late materialization** in the scan operator — wide columns are never decoded for rows that didn't survive every other filter.\n4. **Tantivy embedded inline** in segments, not a separate index.\n5. **WAL on object storage** with conditional PUT, queryable on PUT-ack and merged with compacted segments at query time.\n\nEverything else is supporting infrastructure.\n\n## Quickstart\n\n### Install (30-second start)\n\nOne line on macOS or Linux — the installer detects your OS + arch and drops the `zen` binary in `~\u002F.local\u002Fbin`:\n\n```bash\n# macOS (Apple Silicon or Intel) and Linux (arm64 or amd64)\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FPolarityinc\u002Fzenith\u002Fmain\u002Finstall.sh | sh\n\n# pin a version, or change the install dir\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FPolarityinc\u002Fzenith\u002Fmain\u002Finstall.sh \\\n  | VERSION=v0.1.0 INSTALL_DIR=\u002Fusr\u002Flocal\u002Fbin sh\n```\n\nThen start a local server in seconds (in-memory catalog + local-FS object store, no Docker, no Postgres):\n\n```bash\nzen serve --config examples\u002Fzenithdb.dev.toml\n# HTTP :8080  |  gRPC :50051  |  data under .\u002Fdata\u002F\n```\n\n### Build from source\n\nIf you'd rather build it yourself (or `install.sh` has no release for your platform yet):\n\n- Rust **1.87+** (stable)\n- `protoc` 3.21+ (`brew install protobuf` on macOS, `apt-get install protobuf-compiler` on Debian\u002FUbuntu)\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FPolarityinc\u002Fzenith.git\ncd zenith\ncargo build --release\n\n# Default profile: in-memory `MockCatalog` + local-FS object store. No Docker required.\ncargo run --release -p zen_cli -- serve --config examples\u002Fzenithdb.dev.toml\n```\n\nThe server listens on `:8080` (HTTP) and `:50051` (gRPC). Data lives under `.\u002Fdata\u002F`.\n\n### Ingest and query\n\n```bash\n# Ingest a trace\ncurl -s localhost:8080\u002Fv1\u002Fingest -H 'content-type: application\u002Fjson' -d '{\n  \"trace_id\": \"01HZ...\",\n  \"spans\": [{\n    \"span_id\": \"01HZ...A\",\n    \"name\": \"agent.run\",\n    \"start_time\": \"2026-05-07T12:00:00Z\",\n    \"attributes\": {\"model\": \"claude-opus-4-7\", \"tokens\": 4321}\n  }]\n}'\n\n# Query with SQL\ncurl -s 'localhost:8080\u002Fv1\u002Fquery' -H 'content-type: application\u002Fjson' -d '{\n  \"sql\": \"SELECT model, count(*) FROM spans WHERE start_time > now() - 1h GROUP BY model\"\n}'\n```\n\n### Production-like local stack (Postgres + MinIO)\n\n```bash\ndocker compose -f deploy\u002Fdocker\u002Fdocker-compose.dev.yml up -d\nZEN_PROFILE=prod-like cargo run --release -p zen_cli -- serve\n```\n\n## Architecture\n\n```\nClients (SDKs, OTLP, REST, gRPC)\n            │\n            ▼\n       Gateway (axum + tonic)\n        │           │\n   ingest         queries\n        │           │\n   Writer       Querier\n   (memtable)   (planner + exec)\n        │           │\n        ▼           ▼\n   Catalog (Postgres)\n        │\n        ▼\n  Object storage (local-fs \u002F S3 \u002F GCS \u002F Azure)\n   - WAL    (.wal)\n   - Segments (.zseg)\n```\n\nThe workspace is 18 Rust crates under [`crates\u002F`](crates). The five \"moat\" crates that contain the engine's defining work:\n\n| Crate | What it does |\n|-------|--------------|\n| [`zen_format`](crates\u002Fzen_format)       | PAX segment encoder\u002Fdecoder, FSST\u002FZSTD\u002FGorilla\u002FFoR\u002FRLE\u002Fdict codecs, footer & offset directory layout. |\n| [`zen_compactor`](crates\u002Fzen_compactor) | Streaming k-way merge compactor that enforces trace-locality. |\n| [`zen_query`](crates\u002Fzen_query)         | Vectorized scan operator, late materialization, predicate pushdown. |\n| [`zen_fts`](crates\u002Fzen_fts)             | Tantivy-as-a-library embedded inline in segments. |\n| [`zen_wal`](crates\u002Fzen_wal)             | Object-storage WAL with conditional PUT, queryable on ack. |\n\nThe remaining crates (`zen_storage`, `zen_memtable`, `zen_catalog`, `zen_index`, `zen_jsonpath`, `zen_vector`, `zen_compress`, `zen_server`, `zen_cli`, `zen_cluster`, `zen_auth`, `zen_crypto`, `zen_proto`, `zen_ql`, `zen_bench`, `zen_common`) are supporting infrastructure.\n\n## Configuration\n\nThe default profile runs entirely on your laptop with no external services:\n\n- **Catalog** — Postgres (production) or in-memory `MockCatalog` (dev\u002Ftest, set in config)\n- **Object store** — local filesystem at `.\u002Fdata\u002Fblobs\u002F`\n- **NVMe page cache** — in-process, default 4 GiB\n\nSee [`examples\u002Fzenithdb.dev.toml`](examples\u002Fzenithdb.dev.toml) for the full config surface, and [`docs\u002FRUNBOOK.md`](docs\u002FRUNBOOK.md) for production tuning.\n\n## Console (web dashboard)\n\nZenithDB ships with a minimal Next.js console under [`web\u002F`](web) that\ntalks to the engine's HTTP API. It exposes live segments, queries,\ncompactions, WAL metrics, and a query runner — no fixtures, all real\ndata.\n\n```bash\ncd web\nbun install\nbun dev   # http:\u002F\u002Flocalhost:3000\n```\n\nConfigure the upstream via `ZENITH_URL` (default `http:\u002F\u002Flocalhost:8080`).\n\n## Documentation\n\n- **[Architecture](docs\u002FARCHITECTURE.md)** — deep dive on the five moat crates and the design choices.\n- **[Runbook](docs\u002FRUNBOOK.md)** — operator's guide.\n- **[Examples](examples)** — `zenithdb.dev.toml` config + Python and TypeScript quickstarts.\n- **[Changelog](CHANGELOG.md)** — what landed when.\n- **[Contributing](CONTRIBUTING.md)** — dev setup, conventions, PR workflow.\n- **[Security](SECURITY.md)** — vulnerability disclosure.\n- **[Code of Conduct](CODE_OF_CONDUCT.md)** — community standards.\n\n## Status\n\nZenithDB is **alpha**. The core engine is feature-complete and runs the full benchmark suite, but on-disk format and wire protocols may still change before `1.0`. Track the [CHANGELOG](CHANGELOG.md) for breaking changes.\n\n## Community\n\n- **Issues & feature requests** — [GitHub Issues](https:\u002F\u002Fgithub.com\u002FPolarityinc\u002Fzenith\u002Fissues)\n- **Discussions** — [GitHub Discussions](https:\u002F\u002Fgithub.com\u002FPolarityinc\u002Fzenith\u002Fdiscussions)\n- **Security disclosures** — see [SECURITY.md](SECURITY.md)\n- **Contact** — [support@polarity.so](mailto:support@polarity.so)\n\n## Contributing\n\nWe welcome contributions of all sizes — bug reports, docs, tests, and code. Start with [CONTRIBUTING.md](CONTRIBUTING.md). The codebase has an opinionated structure (see [Architecture](#architecture)); for non-trivial changes, open an issue first so we can align before you write code.\n\n## License\n\nZenithDB is licensed under the [Apache License 2.0](LICENSE). Third-party notices in [NOTICE](NOTICE).\n\nCopyright © 2026 [Polarity, Inc.](https:\u002F\u002Fpolarity.so)\n","ZenithDB 是一个专为AI代理追踪设计的开源列式数据库引擎。它使用Rust语言编写，支持HTTP、gRPC和OTLP接口，并兼容SQL和ZenithQL查询语言。ZenithDB的核心技术特点包括PAX段格式、在压缩时保持追踪局部性、延迟物化扫描操作、嵌入式Tantivy索引以及基于对象存储的WAL机制等五项关键设计选择，这些特性使得该数据库能够高效处理长且稀疏的高基数JSON追踪数据，同时具备低成本存储与快速查询的优势。适用于需要对AI系统运行状态进行深度监控和分析的场景，如复杂的分布式应用程序性能管理或机器学习模型训练过程中的行为追踪。",2,"2026-06-11 03:54:58","CREATED_QUERY"]