timeplus/proton repository overview

Timeplus Proton — fastest SQL pipeline engine for streaming analytics and AI

Timeplus Proton is a high‑performance streaming SQL engine in a single C++ binary. It unifies stream processing with analytical storage, letting you build real‑time ETL, dashboards, alerts, and AI/ML features with millisecond latency. No JVM. No ZooKeeper. Powered by ClickHouse.

• Key capabilities:

  • Native sources/sinks: Kafka/Redpanda, ClickHouse, MySQL, Postgres, S3/Iceberg
  • Streaming SQL: tumble/hop/session windows, watermarks, multi‑stream joins
  • Incremental materialized views, alerts, tasks
  • UDFs in Python and JavaScript
  • Append‑only or mutable streams; unify real‑time + historical
  • ClickHouse compatibility for thousands of SQL functions

• Why Proton:

  • C++ engine with SIMD acceleration for ultra‑low latency
  • Single binary, zero external dependencies
  • A lightweight alternative to Apache Flink and ksqlDB with integrated storage

Quick start

• Run the server:

docker run -d --pull always \
  -p 3218:3218 -p 8463:8463 \
  --name proton timeplus/proton:latest

• Then connect:
  • Native TCP client: map 8463 and use the Proton client
  • Proton REST/HTTP API is available on port 3218 if exposed; see Ports

Ports

• 3218: Proton HTTP/REST API
• 8123: HTTP table interface
• 8463: Native TCP
• 7587: TCP snapshot
• 5432: PostgreSQL protocol
• 9363: Prometheus metrics at /metrics See the server ports guide for details: docs.timeplus.com/proton-ports⁠

Usage

• Start the SQL shell with proton client (native TCP)
• Kafka/Redpanda external streams and ClickHouse external tables are supported; examples and SQL patterns in the repo’s examples folder and the Proton docs

Examples

• Examples: GitHub examples⁠
• Tumble window aggregation, last‑X queries, streaming joins, materialized streaming views

Tags and versions

• latest: current stable
• Versioned tags (e.g., 3.x.y) are recommended for production pinning

Links

• Docs: docs.timeplus.com/proton⁠
• GitHub: timeplus-io/proton⁠
• Slack: timeplus.com/slack⁠
• Releases: GitHub Releases⁠

License

• Apache License 2.0

Maintainers

• Timeplus, Inc. — issues and discussions on GitHub; community support via Slack