How do I set up Neocons with a local Neo4J database for development?

You need to run a Neo4J server locally, for example using Docker with ports 7474 and 7687 exposed, and pass credentials via environment variables like NEO4J_LOGIN and NEO4J_PASSWORD, as described in the Development section of the README.

Neocons or Titanium for graph databases in Clojure?

Neocons is best for Neo4J Server integration with REST and Bolt support, while Titanium is an embeddable EPL-licensed graph database alternative. Choose Neocons for commercial Neo4J projects and Titanium if you need embedding with non-GPL licenses, as hinted in the FAQ.

What Neo4J versions does Neocons currently support?

Neocons 3.2 targets Neo4J Server 3.0.x & 3.1.x with Bolt Protocol, while older versions support Neo4J 2.x. It's actively tested against stable releases, but check the compatibility matrix in the README for specifics.

How to execute Cypher queries efficiently with Neocons?

Use the provided Cypher query functions via either REST API or Bolt Protocol, and leverage efficient multi-get operations through Cypher, as mentioned in the Supported Features for performance optimization.

Does Neocons work with cloud Neo4J services like Aura or GrapheneDB?

Yes, it supports Basic HTTP authentication and is compatible with Heroku GrapheneDB, as stated in the features. For other cloud services, ensure they use compatible REST or Bolt endpoints.

Neocons performance with Bolt vs REST API in production?

Bolt Protocol typically offers better performance for Cypher queries and transactions due to binary encoding, but REST API provides more features. Use Bolt for latency-sensitive operations and REST for broader functionality, based on the supported features list.

Open-Awesome

neocons

Clojure

A feature-rich idiomatic Clojure client for the Neo4J REST API and Bolt Protocol.

Visit Website GitHub

207 stars31 forks0 contributors

What is neocons?

Neocons is a Clojure client library for Neo4J graph databases that provides access via both REST API and Bolt Protocol. It enables Clojure developers to interact with Neo4J Server edition using an idiomatic Clojure interface, supporting all major Neo4J features including Cypher queries, transactions, and graph traversal operations.

Target Audience

Clojure developers building applications that require graph database functionality, particularly those using Neo4J Server edition in commercial projects where business-friendly licensing is important.

Value Proposition

Developers choose Neocons for its mature, production-tested implementation, comprehensive Neo4J feature support, and idiomatic Clojure API that integrates seamlessly with the Clojure ecosystem while maintaining compatibility with multiple Neo4J versions.

Overview

A feature rich idiomatic Clojure client for the Neo4J REST API

Use Cases

Best For

Building Clojure applications that require Neo4J graph database connectivity
Commercial projects needing business-friendly licensed Neo4J clients
Applications requiring both REST API and Bolt Protocol support for Neo4J
Teams already using other ClojureWerkz libraries like Monger or Langohr
Projects that need comprehensive Neo4J feature coverage including labels and constraints
Heroku deployments using GrapheneDB Neo4J add-on

Not Ideal For

Projects requiring Neo4J embedding with non-GPL licensing, as Neocons explicitly avoids this due to licensing conflicts
Teams exclusively using Neo4J's Bolt Protocol for advanced features beyond basic Cypher queries and transactions
Applications needing the absolute latest Neo4J server versions not yet covered in Neocons' compatibility matrix

Pros & Cons

Pros

Mature Production Stability

First released in 2011 and used in production from early on, with a stable API and good documentation, as noted in the project maturity section.

Comprehensive Feature Support

Supports a wide range of Neo4J features including Cypher queries, transactions, labels, constraints, and both REST API and Bolt Protocol, as detailed in the Supported Features list.

Business-Friendly Licensing

Designed for commercial projects, it enables use of open-source Neo4J Server edition without GPL issues, highlighted in the FAQ and licensing sections.

ClojureWerkz Integration

Part of the ClojureWerkz library family, ensuring an idiomatic Clojure experience and compatibility with tools like Monger and Langohr, as mentioned in the project description.

Cons

Limited Bolt Protocol Features

Bolt Protocol support is restricted to Cypher queries, sessions, and transactions, lacking the full feature set available via REST API, as indicated in the Supported Features breakdown.

No Embedding Support

Due to Neo4J's GPL license, Neocons does not support embedding, which can be a limitation for projects requiring embedded graph databases, as explained in the FAQ.

Setup Complexity for Development

Testing requires a running Neo4J instance, such as using Docker with specific credentials, adding overhead compared to libraries with simpler in-memory options, as shown in the Development section.

Frequently Asked Questions

Related Projects

Gephi

Gephi - The Open Graph Viz Platform

Stars6,590

Forks1,606

Last commit26 days ago

Apoc : Awesome Procedures on Cypher

Awesome Procedures On Cypher for Neo4j - codenamed "apoc" If you like it, please ★ above ⇧

A Property Graph Model Interface (no longer active - see Apache TinkerPop)

Stars1,359

Forks270

Last commit5 years ago

node-neo4j

[RETIRED] Neo4j graph database driver (REST API client) for Node.js

Stars921

Forks133

Last commit7 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub