Scio Logo

Ecclesiastical Latin IPA: /ˈʃi.o/, [ˈʃiː.o], [ˈʃi.i̯o] Verb: I can, know, understand, have knowledge.


Scio is a Scala API for Apache Beam and Google Cloud Dataflow inspired by Apache Spark and Scalding.

Getting Started is the best place to start with Scio. If you are new to Apache Beam and distributed data processing, check out the Beam Programming Guide first for a detailed explanation of the Beam programming model and concepts. If you have experience with other Scala data processing libraries, check out this comparison between Scio, Scalding and Spark.

Example Scio pipelines and tests can be found under scio-examples. A lot of them are direct ports from Beam’s Java examples. See this page for some of them with side-by-side explanation. Also see Big Data Rosetta Code for common data processing code snippets in Scio, Scalding and Spark.

See Scio Scaladocs for current API documentation.

Getting help

  • GitHub Discussions
  • Google Group
  • Stack Overflow



  • Avro - using Scio with Avro files
  • BigQuery - using Scio with BigQuery in a type safe way
  • Bigtable - using Scio with Bigtable
  • Parquet - using Scio with Parquet files
  • Protobuf - using Scio with Protobuf



Further Readings


Projects using or related to Scio

  • Featran - A Scala feature transformation library for data science and machine learning
  • Big Data Rosetta Code - Code snippets for solving common big data problems in various platforms. Inspired by Rosetta Code
  • Ratatool - A tool for random data sampling and generation, which includes BigDiffy, a Scio library for pairwise field-level statistical diff of data sets (slides)
  • Elitzur - Data validation for Scala and Scio
  • Scio Koans - A collection of Scio exercises inspired by Ruby Koans and many others.
  • scio-deep-dive - Building Scio from scratch step by step for an internal training session
  • Klio - Large scale audio or binary file processing with Python and Apache Beam
  • scala-flow - A lightweight Scala wrapper for Google Cloud Dataflow from Zendesk
  • clj-headlights - Clojure API for Apache Beam, also from Zendesk
  • datasplash - A Clojure API for Google Cloud Dataflow