Skip to main content

Turns command-line NLP tools into fully-fledged RESTful webservices with an auto-generated web-interface for human end-users.

Project description Documentation Status Latest release in the Python Package Index Project Status: Active – The project has reached a stable, usable state and is being actively developed.

by Maarten van Gompel Centre for Language and Speech Technology, Radboud University Nijmegen & KNAW Humanities Cluster

Licensed under GPLv3

Website: Source repository: Documentation: Installation: pip install clam

CLAM allows you to quickly and transparently transform your Natural Language Processing application into a RESTful webservice, with which both human end-users as well as automated clients can interact. CLAM takes a description of your system and wraps itself around the system, allowing end-users or automated clients to upload input files to your application, start your application with specific parameters of their choice, and download and view the output of the application once it is completed.

CLAM is set up in a universal fashion, requiring minimal effort on the part of the service developer. Your actual NLP application is treated as a black box, of which only the parameters, input formats and output formats need to be described. Your application itself needs not be network aware in any way, nor aware of CLAM, and the handling and validation of input can be taken care of by CLAM.

CLAM is entirely written in Python, runs on UNIX-derived systems, and is available as open source under the GNU Public License (v3). It is set up in a modular fashion, and offers an API, and as such is easily extendable. CLAM communicates in a transparent XML format, and using XSL transformation offers a modern client-side generated web-interface for human end users.


Documentation is available on

Some screenshots of the web user interface can be found below:

the clam project list the clam project page during staging the clam project page when done


It’s discouraged to download the zip packages or tarballs from github, install CLAM from the Python Package Index or use git properly.

Installation On Linux

Installation from the Python Package Index using the package manager pip it the recommended way to intall CLAM. This is the easiest method of installing CLAM, as it will automatically fetch and install any dependencies. We recommend to use a virtual environment (virtualenv) if you want to install CLAM locally as a user, if you want to install globally, prepend the following commands with sudo:

CLAM can be installed from the Python Package Index using pip. Pip is usually part of the python3-pip package (Debian/Ubuntu) or similar. It downloads CLAM and all dependencies automatically::

$ pip3 install clam

If you already downloaded CLAM manually (from github), you can do:

$ python3 install
If pip3 is not yet installed on your system, install it using:

on debian-based linux systems (including Ubuntu):

$ apt-get install python3-pip

on RPM-based linux systems:

$ yum install python3-pip

Note that sudo/root access is needed to install globally. Ask your system administrator to install it if you do not own the system. Alternatively, you can install it locally in a Python virtual environment:

$ virtualenv –python=python3 clamenv

$ . clamenv/bin/activate

(clamenv)$ pip3 install clam

CLAM also has some optional dependencies. For MySQL support, install mysqlclient using pip. For FoLiA support, install FoLiA-Tools using pip.

Running a test webservice

If you installed CLAM using the above method, then you can launch a clam test webservice using the development server as follows:

$ clamservice -H localhost -p 8080 clam.config.textstats

Navigate your browser to http://localhost:8080 and verify everything works

Note: It is important to regularly keep CLAM up to date as fixes and improvements are implemented on a regular basis. Update CLAM using:

$ pip install -U clam

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for CLAM, version 3.1.0
Filename, size File type Python version Upload date Hashes
Filename, size CLAM-3.1.0.tar.gz (571.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page