Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Real-time search with autocomplete via redis
branch: master

Merge pull request #1 from newco/master

exporting deleteAll function
latest commit f6a6e1dd76
Jed Parsons authored
Failed to load latest commit information.
example example was a bit out of date with completer
test added some tests
.gitignore initial template
.gitmodules moved app to example/example.js
LICENSE have fun minor edits
completer.js Forgot about default arg score
package.json added some tests

redis-completer for node.js

An implementation of antirez's for node.js.


npm install redis-completer


Get a completer and provide a unique namespace for your app:

$ node
> completer = require('redis-completer');
> completer.applicationPrefix('winning');

That prefix prevents key conflics in redis. Make sure you use a prefix for each project.

Add completions for a document:

> completer.addCompletions(text, id, score);

id and score are optional. If id is null, it will be ignored.

If an id is provided, it will be concatenated with text in the final lookup table making a compound key of the form id:text. The idea here is to give you a way to stash a database key and a chunk of text together, so you can find your way back to some document you have stored elsewhere. E.g., if you're auto-completing a search by title, you could use the key to help retrieve the entire document.

Completions are sorted by score, so use that to weight documents you want to show up first.

Here's an example showing show score is reflected in search results:

> // adding completions:    text              id  score
> completer.addCompletions("Have some pie",    1,    42);
> completer.addCompletions("Have some quiche", 2,     6);
> completer.addCompletions("I prefer quiche",  3,    99);

> // convenience to print results
> function print(err, results) { console.log(results) }

>"have", 10, print);
[ '1:Have some pie', '2:Have some quiche' ]
>"quiche", 10, print);
[ '3:I prefer quiche', '2:Have some quiche' ]

It's up to me to remember that I used a key and deal with that when I process the text.

When multi-word phrases are matched, the scores for matches accumulate. For example:

> completer.addCompletions("something borrowed", 'one',  6);
> completer.addCompletions("something blue",     'two', 10);

// most valuable match first
>"some", 10, print);
[ 'two:something blue', 'one:something borrowed' ]

// most valuable match after accumulating scores first
>"something borr", 10, print);
[ 'one:something borrowed', 'two:something blue' ]


Sebastian Sanfilippo posted this really neat gist, which shows how to make search tries in redis for fast search completers.

I found j4mie's translation of the same to python, which I extended to allows for multi-word searches.

This is another translation of those examples for node.js. It has the following components:

  • A front-end with backbone models for searching and displaying results
  • A completer.js that provides multi-word completion via redis
  • An example app that lets the front-end communicate with completer via now.js

In the example/data directory is a file containing a little over 1000 tweets. (These tweets are mashups of Kanye West + Victor Medvedev and Martha Stewart + Lady Gaga, produced by my markov-tweeter.)

When you run example/app.js, it will make sure these have been processed and shoved into redis. This may take a few moments to complete, but it happens asynchronously, so you can start using the app right away.

On the web page, start typing, and hopefully we'll see a real-time search for tweets.

Something went wrong with that request. Please try again.