Apache TinkerPop™

Apache TinkerPop™ is a graph computing framework for both graph databases (OLTP) and graph analytic systems (OLAP).

TinkerPop 3.3.2 (Released: 2-Apr-2018)

Downloads

Gremlin Console Gremlin Server Source

Documentation

- TinkerPop Documentation

- Reference Documentation

- Upgrade Information
- TinkerPop Javadoc - core / full

Understand Gremlin
Become TinkerPop-Enabled

1. 1
2. 2
3. 3
4. 4
5. 5

        // What are the names of Gremlin's friends' friends?
        g.V().has("name","gremlin").
          out("knows").out("knows").values("name")

        // What are the names of projects that were created by two friends?
        g.V().match(
          as("a").out("knows").as("b"),
          as("a").out("created").as("c"),
          as("b").out("created").as("c"),
          as("c").in("created").count().is(2)).
            select("c").by("name")

        // What are the names of the managers in
        //  the management chain going from Gremlin to the CEO?
        g.V().has("name","gremlin").
          repeat(in("manages")).until(has("title","ceo")).
          path().by("name")

        // What is the distribution of job titles amongst Gremlin's collaborators?
        g.V().has("name","gremlin").as("a").
          out("created").in("created").
            where(neq("a")).
          groupCount().by("title")

        // Get a ranking of the most relevant products for Gremlin given his purchase history.
        g.V().has("name","gremlin").out("bought").aggregate("stash").
          in("bought").out("bought").
            where(not(within("stash"))).
          groupCount().
            order(local).by(values,decr)

### The Benefits of Graph Computing

A graph is a structure composed of vertices and edges. Both vertices and edges can have an arbitrary number of key/value-pairs called properties. Vertices denote discrete objects such as a person, a place, or an event. Edges denote relationships between vertices. For instance, a person may know another person, have been involved in an event, and/or was recently at a particular place. Properties express non-relational information about the vertices and edges. Example properties include a vertex having a name, an age and an edge having a timestamp and/or a weight. Together, the aforementioned graph is known as a property graph and it is the foundational data structure of Apache TinkerPop.

If a user's domain is composed of a heterogenous set of objects (vertices) that can be related to one another in a multitude of ways (edges), then a graph may be the right representation to use. In a graph, each vertex is seen as an atomic entity (not simply a "row in a table") that can be linked to any other vertex or have properties added or removed at will. This empowers the data modeler to think in terms of actors within a world of complex relations as opposed to, in relational databases, statically-typed tables joined in aggregate. Once a domain is modeled, that model must then be exploited in order to yield novel, differentiating information. Graph computing has a rich history that includes not only query languages devoid of table-join semantics, but also algorithms that support complex reasoning: path analysis, vertex clustering and ranking, subgraph identification, and more. The world of applied graph computing offers a flexible, intuitive data structure along with a host of algorithms able to effectively leverage that structure.

Apache TinkerPop™ is an open source, vendor-agnostic, graph computing framework distributed under the commercial friendly Apache2 license. When a data system is TinkerPop-enabled, its users are able to model their domain as a graph and analyze that graph using the Gremlin graph traversal language. Furthermore, all TinkerPop-enabled systems integrate with one another allowing them to easily expand their offerings as well as allowing users to choose the appropriate graph technology for their application. Sometimes an application is best served by an in-memory, transactional graph database. Sometimes a multi-machine distributed graph database will do the job. Or perhaps the application requires both a distributed graph database for real-time queries and, in parallel, a Big(Graph)Data processor for batch analytics. Whatever the application's requirements, there exists a TinkerPop-enabled graph system out there to meet its needs.

### Contributing to Apache TinkerPop

TinkerPop is an open source project that welcomes contributions. There are many ways to get involved:

1. Join the Gremlin-Users public mailing list.
   - Help users by answering questions and demonstrating your expertise in TinkerPop and graphs.
2. Join the TinkerPop Developer public mailing list.
   - Contribute ideas on how to make the TinkerPop code- and documentation-base better.
3. Submit bug and feature issues to TinkerPop JIRA.

- Provide easily reproducible bug reports and well articulated feature requests.

4. Clone the TinkerPop Git repository and provide a pull-request.
   - Focus on a particular area of the codebase and take responsibility for your contribution.
5. Make significant, long lasting contributions over time.

- Become a TinkerPop Committer and help determine the evolution of The TinkerPop.

To build TinkerPop from source, please review the developer documentation.

### Community Contributions

TinkerPop is at the center of a larger development ecosystem that extends on its core interfaces, integration points, and ideas. The graph systems and libraries below represent both TinkerPop-maintained reference implementations as well as third-party managed projects. The TinkerPop community is always interested in hearing about projects like these and aiding in their support. Please read our provider listing policy and feel free to promote such projects on the user and developer mailing lists. Information on how to build implementations of the various interfaces that TinkerPop exposes can be found in the Provider Documentation.

#### Graph Systems

[learn more]

- Amazon Neptune - Fully-managed graph database service.
- Bitsy - A small, fast, embeddable, durable in-memory graph database.
- Blazegraph - RDF graph database with OLTP support.
- CosmosDB - Microsoft's distributed OLTP graph database.
- ChronoGraph - A versioned graph database.
- DSEGraph - DataStax graph database with OLTP and OLAP support.
- GRAKN.AI - Distributed OLTP/OLAP knowledge graph system.
- Hadoop (Giraph) - OLAP graph processor using Giraph.
- Hadoop (Spark) - OLAP graph processor using Spark.
- HGraphDB - OLTP graph database running on Apache HBase.
- IBM Graph - OLTP graph database as a service.
- JanusGraph - Distributed OLTP and OLAP graph database with BerkeleyDB, Apache Cassandra and Apache HBase support.
- JanusGraph (Amazon) - The Amazon DynamoDB Storage Backend for JanusGraph.
- Neo4j - OLTP graph database (embedded and high availability).
- neo4j-gremlin-bolt - OLTP graph database (using Bolt Protocol).
- OrientDB - OLTP graph database
- Apache S2Graph - OLTP graph database running on Apache HBase.
- Sqlg - OLTP implementation on SQL databases.
- Stardog - RDF graph database with OLTP and OLAP support.
- TinkerGraph - In-memory OLTP and OLAP reference implementation.
- Titan - Distributed OLTP and OLAP graph database with BerkeleyDB, Apache Cassandra and Apache HBase support.
- Titan (Amazon) - The Amazon DynamoDB storage backend for Titan.
- Titan (Tupl) - The Tupl storage backend for Titan.
- Unipop - OLTP Elasticsearch and JDBC backed graph.

#### Query Languages

[learn more]

- Ferma (java/dsl) - An ORM / OGM for Apache TinkerPop.
- Goblin (python/dsl) - Goblin OGM for the TinkerPop 3 Gremlin Server.
- Gremlin.Net (.NET - C#/variant) - Gremlin hosted in C# for use with any .NET-based VM.
- gremlin-orm (javascript) Gremlin ORM for Node.js.
- gremlin-python (python/variant) - Gremlin hosted in Python for use with any Python-based VM.
- gremlin-py (python/variant) - Write pure Python Gremlin that can be sent to Gremlin Server.
- gremlin-scala (scala/variant) - A Scala-based Gremlin language variant for TinkerPop3.
- gremlin-objects (java/dsl) - An Object Graph Mapping Library For Gremlin.
- gremlin-template-string (js/variant) - A Gremlin language builder.
- ipython-gremlin (python/variant) - Gremlin in IPython and Jupyter.
- ogre (clojure/variant) - A Clojure language wrapper for TinkerPop3.
- Peapod (java/dsl) - An object-graph-wrapper.
- sparql-gremlin (sparql/distinct) - A SPARQL to Gremlin traversal compiler.
- sql-gremlin (sql/distinct) - An SQL to Gremlin traversal compiler.

#### Language Drivers

- gremlinclient (python) - An asynchronous Python 2/3 client for Gremlin Server that allows for flexible coroutine syntax - Trollius, Tornado, Asyncio.
- gremlin_client (ruby) - A Gremlin Server driver for Ruby.
- gremlin-driver (java) - A Gremlin Server driver for Java.
- gremlin-javascript (js) - A Gremlin Server driver for JavaScript.
- gremgo (go) - A Gremlin Server driver for Go.
- Gremlin.Net (.NET - C#) - Gremlin Server driver for .NET.
- gremlin-php (php) - A Gremlin Server driver for PHP.
- gremlin-python (python) - Gremlin Server driver for Python.
- gremlinrestclient (python) - Python 2/3 library that uses HTTP to communicate with the Gremlin Server over REST.
- python-gremlin-rest (python) - A REST-based client for Gremlin Server.
- reactive-gremlin (scala) - An Akka HTTP Websocket Connector.
- scalajs-gremlin-client (scala) - A Gremlin-Server client with ad-hoc extensible, reactive, typeclass based API.
- ts-tinkerpop (typescript) - A helper library for Typescript applications via node-java.

#### Powered By

- Graphexp - Interactive visualization of the Gremlin graph database with D3.js.
- Pitney Bowes Spectrum Data Hub Module - Uses Gremlin OLTP to query Neo4j-powered master data management based graph database.

### Apache TinkerPop Committers

TinkerPop seeks committers dedicated to the art of graph computing. TinkerPop committers bring solid theoretical, development, testing, documentation, etc. skills to the group. Committers contribute to TinkerPop beyond the ever-changing requirements of their day-to-day jobs and maintain responsibility for their contributions through time.

- Marko A. Rodriguez (2009 - PMC): Gremlin language, Gremlin machine, documentation.
- Ketrina Yim (2009 - Committer): Illustrator, creator of Gremlin and his merry band of robots.
- Stephen Mallette (2011 - PMC Chair): Gremlin Console/Server/Driver, Graph I/O, testing, documentation, mailing list support.
- James Thornton (2013 - PMC): Promotions, evangelism.
- Daniel Kuppitz (2014 - PMC): Gremlin language design, benchmarking, testing, documentation, mailing list support.
- Hadrian Zbarcea (2015 - PMC): Project mentor, provider liason.
- Daniel Gruno (2015 - PMC): Project mentor, infrastructure liason.
- Matt Frantz (2015 - Committer): Gremlin language design, ts-tinkerpop.
- Jason Plurad (2015 - PMC): Gremlin Console/Server, mailing list support.
- Dylan Millikin (2015 - PMC): Gremlin Server/Driver, gremlin-php, GremlinBin, mailing list support.
- Ted Wilmes (2015 - PMC): Promotions, mailing list support, benchmarking, sql-gremlin.
- Pieter Martin (2016 - Committer): Gremlin language, Sqlg.
- Jean-Baptiste Musso (2016 - Committer): Gremlin Server testing, Gremlin Driver (Node.js/JavaScript), mailing list support.
- Michael Pollmeier (2016 - Committer): Gremlin language, Gremlin-Scala.
- David Brown (2016 - Committer): Python libraries, Gremlin Server testing.
- Robert Dale (2016 - PMC): Gremlin Console/Server, documentation, mailing list support.
- Jorge Bay (2017 - Committer): JavaScript and .NET libraries, mailing list support.
- Florian Hockmann (2017 - Committer): .NET libraries, mailing list support.
- Kelvin Lawrence (2017 - Committer): Documentation and mailing list support.