What it is

activegraph is a Ruby and JRuby wrapper for the Neo4j graph database, formerly called Neo4j.rb. It provides an Active Model compliant wrapper over Neo4j, so Ruby applications can work with graph data through model code and associations instead of writing low-level database calls. The project lives in the Ruby ecosystem and sits in the database and infrastructure category, with topics that include graph-database, neo4j, orm, railtie, and ruby.

The concrete problem it solves is connecting Ruby applications to Neo4j while preserving a familiar model-and-query style. Neo4j stores information in nodes and relationships, and both nodes and relationships can have arbitrary properties. activegraph wraps the neo4j-ruby-driver and uses the active_attr gem, then exposes a higher-level query interface that lets developers traverse associations and build Neo4j queries from Ruby code.

Key capabilities

• It provides an Active Model compliant wrapper for Neo4j in Ruby and JRuby applications.
• It uses the neo4j-ruby-driver to communicate with the Neo4j graph database.
• It uses the active_attr gem as part of its model support.
• It exposes a high-level query building interface for traversing associations and expressing Neo4j queries in Ruby.
• It supports graph data modeled as nodes and relationships with arbitrary properties.
• It has a version support matrix covering Neo4j releases from 1.9 through 5.x across different activegraph releases.
• It is installed as a Ruby gem with the name neo4j in a Gemfile.

Who uses it and how

• Ruby and JRuby applications use it when the data model is graph-shaped, with nodes and relationships that carry properties.
• Rails-oriented Ruby projects can use it because the repository topics include railtie, indicating integration with Rails-style application structure.
• Developers use it to express queries through Ruby chains rather than writing every database interaction directly against the driver.
• Teams choose a specific activegraph version to match the Neo4j version they run, as shown by the README version support table.
• Users can seek support through the documented StackOverflow, Gitter, Twitter, readthedocs, and wiki resources.

Getting started

The README says the gem can be installed in a Gemfile with gem 'neo4j'. General documentation is provided through the neo4jrb.io website and readthedocs, while some older documentation remains on the project wiki.

When to use it — and when not to

activegraph is useful when a Ruby or JRuby application needs an Active Model wrapper layer over Neo4j and the team is already prepared to operate Neo4j itself. It is not a standalone database, so users must run a supported Neo4j version and select a matching activegraph release. The facts also show 242 open issues, no listed contributor count, and documentation partly split between readthedocs and an older wiki, which can make evaluation and upgrades require more care.

# Break down the top countries where friends' favorite beers come from
person.friends.favorite_beers.country_of_origin(:country).
  order('count(country) DESC').
  pluck(:country, count: 'count(country)')