Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Please use the official java-driver at for all Java-based Apache Cassandra projects.  

My most sincere thanks to the other project collaborators and the many people that contributed features, bugs and patches over the years. 



Original README for posterity

The currently active branch is 1.0. The master tracks Apache Cassandra active development which is 1.1.x presently. Current releases on the downloads section should be cosidered production ready. You should always choose the most recent release for your version of Apache Cassandra.

For the impatient:

All Hector artifacts are deployed to Maven Central. If you use maven for your build system, you need only include the hector-core dependency and all related dependencies will be managed automatically. 

Hector is a high level Java client for Apache Cassandra.
Apache Cassandra is a highly available column oriented database:
Hector is the greatest warrior in the greek mythology, Troy's builder and brother of Cassandra

Hector is currently in use on a number of production systems some of which have node counts into the hundreds. Issues generally are fixed as quickly as possible and releases done frequently.

Some features provided by this client:

 o high level, simple object oriented interface to cassandra
 o failover behavior on the client side
 o connection pooling for improved performance and scalability
 o JMX counters for monitoring and management
 o configurable and extensible load balancing with three algorithms to choose from: round robin (the default), least active, and a phi-accrural style response time detector
 o complete encapsulation of the underlying Thrift API and structs
 o automatic retry of downed hosts
 o automatic discovery of additional hosts in the cluster
 o suspension of hosts for a short period of time after several timeouts
 o simple ORM layer that works
 o a type-safe approach to dealing with Apache Cassandra's data model

Detailed documentation of Hector features and usage can be found on Hector web site: (hosted in github pages) 

Some additional pages from the wiki that may be of interest:

 o Mailing Lists: ,
 o Maven Central location (includes javadoc):

Example projects using Hector:


Building Hector from sources

Hector uses maven to build the sources. If you are new to Maven, take a look at this tutorial first:

In order to to build Hector (this is not Hector specific) you run: 

  mvn clean package 
  mvn clean package -DskipTests (to run faster and skip the tests) 

Hector jar will be under <hector_dir>/target