Cypher For Gremlin

Cypher for Gremlin adds Cypher support to any Gremlin graph database.
Alternatives To Cypher For Gremlin
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Dgraph19,08834a day ago174January 05, 2022268otherGo
Native GraphQL Database with graph backend
Janusgraph4,7666429a day ago18May 31, 2022482otherJava
JanusGraph: an open-source, distributed graph database
Graphscope2,2961a day ago54July 06, 2022201apache-2.0Rust
🔨 🍇 💻 🚀 GraphScope: A One-Stop Large-Scale Graph Computing System from Alibaba 来自阿里巴巴的一站式大规模图计算系统 图分析 图查询 图机器学习
Incubator Hugegraph2,20615 days ago5January 19, 2021236apache-2.0Java
A graph database that supports more than 100+ billion data, high performance and scalability (Include OLTP Engine & REST-API & Backends)
Gremlin1,835171376 years ago8September 17, 201421otherJava
A Graph Traversal Language (no longer active - see Apache TinkerPop)
Tinkerpop1,717146723 days ago50July 21, 202120apache-2.0Java
Apache TinkerPop - a graph computing framework
Blueprints1,305370676 years ago8September 17, 201420otherJava
A Property Graph Model Interface (no longer active - see Apache TinkerPop)
Nlp Knowledge Graph1,298
23 days agomit
Awesome Graph794
2 years ago4
A curated list of resources for graph databases and graph computing tools
a month ago83apache-2.0Ruby
Practical Gremlin - An Apache TinkerPop Tutorial
Alternatives To Cypher For Gremlin
Select To Compare

Alternative Project Comparisons

Cypher for Gremlin

CircleCI Maven Central

Cypher for Gremlin is a toolkit for users of Apache TinkerPop™ that allows querying Gremlin databases with Cypher, the industry's most widely used property graph query language defined and maintained by the openCypher project.

Cypher query is translated to one of Gremlin representations (Gremlin Groovy string, Traversal object or Gremlin bytecode):

Table of Contents



Gremlin Console Plugin

Gremlin Console plugin that enables client-side translation of Cypher queries or communication with a Cypher-enabled Gremlin Server (click to play/view source):

Gremlin Server Client

Gremlin Server client wrapper that can send Cypher queries to a Cypher-enabled Gremlin Server or translate Cypher queries to Gremlin on client side, and send translated query to servers:

String cypher = "MATCH (p:person) WHERE p.age > 25 RETURN";

Cluster cluster =;
Client gremlinClient = cluster.connect();

// Server has Gremlin Server plugin installed
// Send Cypher to server
CypherGremlinClient cypherGremlinClient = CypherGremlinClient.plugin(gremlinClient);
List<Map<String, Object>> cypherResults = cypherGremlinClient.submit(cypher).all();

// Client side translation
// Send Gremlin to server
CypherGremlinClient translatingGremlinClient = CypherGremlinClient.translating(gremlinClient);
List<Map<String, Object>> gremlinResults = translatingGremlinClient.submit(cypher).all();


Gremlin Neo4j Driver

Implementation of Neo4j API interfaces for users familiar with Neo4j:

Driver driver = GremlinDatabase.driver(uri);

try (Session session = driver.session()) {
    StatementResult result ="MATCH (n) RETURN count(n) as count");
    int n = result.single().get("count").asInt();

    assertThat(n).isEqualTo(0); // 0

Gremlin Server Plugin

Gremlin Server plugin that enables Cypher query processing on Gremlin Server. For example connect using Gremlin-JavaScript 3.4.2+ by setting processor to cypher:

// npm install [email protected]

const gremlin = require('gremlin');
const client = new gremlin.driver.Client('ws://localhost:8182/gremlin', { traversalSource: 'g', processor: 'cypher'});
const cypherQuery = 'MATCH (n) RETURN'

const results = await client.submit(cypherQuery);

for (const result of results) {

See examples for Gremlin-Java, Gremlin-Groovy, Gremlin-Python and Gremlin.Net

Cypher Traversal Source

For Gremlin Console Plugin and Gremlin Server Client its possible to combine Cypher and Gremlin in single query. Traversal can start with cypher step that allows to run Cypher query (which will be translated to Gremlin and works withRemote) then continue traversal using other Gremlin steps:

CypherTraversalSource g = graph.traversal(CypherTraversalSource.class);

GraphTraversal<Map<String, Object>, String> query = g
    .cypher("MATCH (n) RETURN n")

Quick Start

  1. Run Docker images
  2. Start experimenting with Cypher for Gremlin with the Gremlin Console Cypher plugin. Follow the link for installation and usage instructions.
  3. For API usage take a look at the Cypher for Gremlin Demo project.


The toolkit is composed of:

Language Support

With Cypher for Gremlin you can use the following Cypher language features:

  • WHERE, ORDER BY, SKIP, and LIMIT sub-clauses
  • RETURN, WITH, and UNWIND projections, including basic support for list and path comprehensions
  • CASE expressions
  • UNION (ALL) operations
  • CALL procedures

It is not guaranteed that all instances and combinations of the listed features will work. However, in addition to integration tests, correctness of translation is verified by the Cypher Technology Compatibility Kit (TCK). The TCK is an openCypher artifact and contains a comprehensive set of test scenarios validating different features of the Cypher language.

Coverage of TCK M13 (excluding Temporal Types) on TinkerGraph:

  • 75% of the scenarios are supported with common Gremlin steps
  • Additional 15% with extensions to Gremlin to enable full support for Cypher functionality
  • See latest TCK Report for a detailed overview of language coverage.

You are very welcome to report any issues with the translation that you encounter.

Gremlin Implementations

Cypher for Gremlin is tested on following Gremlin implementations:

Each Gremlin implementation has its own level of Gremlin support and Gremlin step implementation specifics. In some cases, queries need to be adapted for target implementation using flavor.

Because of these specifics, Cypher support varies on different implementations. Refer to wiki for more details.



The translation process uses a reasonably sophisticated and flexible approach. Cypher query is parsed by the openCypher Frontend and translated to an internal representation by the Cypher for Gremlin. The internal representation is transformed by a set of rewriters to adapt the query for system specifics of different Gremlin implementations (JanusGraph, Cosmos DB, AWS Neptune), then converted to one of Gremlin representations (Gremlin Groovy string, Traversal object or Gremlin bytecode).

See also How to implement new Cypher feature?


To build and run Cypher for Gremlin you need Java 8. The project is built using Gradle or the provided wrapper.

To build and run unit and integration tests:

./gradlew build

To automatically fix formatting errors in your changes:

./gradlew spotlessApply

How to contribute

We would love to find out about any issues you encounter and are happy to accept contributions following a Contributors License Agreement (CLA) signature as per the process outlined in our contribution guidelines.


The project is licensed under the Apache Software License, Version 2.0


© Copyright 2018-2019 Neo4j, Inc.

Apache TinkerPop™, TinkerPop, and Apache are registered trademarks of the Apache Software Foundation.

Popular Graph Projects
Popular Gremlin Projects
Popular Computer Science Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.