Python Solr clients

This is a part of the Solr Clients list. As with the main list, the latest source update is listed - where possibly - as a proxy for level of relevance.


solrcloudpy is a library designed specifically for interacting with SolrCloud. It also comes with an interactive console.

Last update: October 2014


solrpy is available at The Python Package Index so you should be able to:

easy_install solrpy

Or you can check out the source code and:

python install

Last update: December 2013


pysolr - lightweight python wrapper for Solr.

Last update: December 2013

Python Solr, Supposedly an enhanced version of pysolr that supports pagination and batch operations. However, the last update was in April 2012.


insolr is another independent Solr API, focused on easy of use in large scale production enviroments, clean and fast, still in development

Last update: December 2013


Sunburnt is a Solr library, both for inserting and querying documents. Its development has aimed particularly at making the Solr API accessible in a Pythonic style.

Last update: February 2014 (has lots of forks though by other groups)


Using Solr's Python output

Solr has an optional Python response format that extends its JSON output in the following ways to allow the response to be safely eval'd by Python's interpreter:

Here is a simple example of how one may query Solr using the Python response format:

from urllib2 import *
conn = urlopen('http://localhost:8983/solr/select?q=iPod&wt=python')
rsp = eval( )

print "number of matches=", rsp['response']['numFound']

#print out the name field for each returned document
for doc in rsp['response']['docs']:
  print 'name field =', doc['name']

With Python 2.6 you can use the literal_eval function instead of eval. This only evaluates "safe" syntax for the built-in data types and not any executable code:

import ast
rsp = ast.literal_eval(

Using normal JSON

Using eval is generally considered bad form and dangerous in Python. In theory if you trust the remote server it is okay, but if something goes wrong it means someone can run arbitrary code on your server (attacking eval is very easy).

It would be better to use a Python JSON library like simplejson. It would look like:

from urllib2 import *
import simplejson
conn = urlopen('http://localhost:8983/solr/select?q=iPod&wt=json')
rsp = simplejson.load(conn)

Safer, and as you can see, easy.

SolPython (last edited 2014-12-03 04:40:38 by AlexandreRafalovitch)