Python 2/3 SDK for interacting with the Boss REST API
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


PyPI version CircleCI

intern (Integrated Toolkit for Extensible and Reproducible Neuroscience) is a Python 2/3 module that enables big-data neuroscience. Currently, it provides an interface to the Boss API, and in the future may provide interfaces to other neuroscience databases.

intern is inspired by the NeuroData ndio package:

The Boss Legal Notes

Use or redistribution of the Boss system in source and/or binary forms, with or without modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code or binary forms must adhere to the terms and conditions of any applicable software licenses.
  2. End-user documentation or notices, whether included as part of a redistribution or disseminated as part of a legal or scientific disclosure (e.g. publication) or advertisement, must include the following acknowledgement: The Boss software system was designed and developed by the Johns Hopkins University Applied Physics Laboratory (JHU/APL).
  3. The names "The Boss", "JHU/APL", "Johns Hopkins University", "Applied Physics Laboratory", "MICrONS", or "IARPA" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact
  4. This source code and library is distributed in the hope that it will be useful, but is provided without any warranty of any kind.


  • It's always a good idea to use virtualenv to isolate your work from your system Python installation

     virtualenv intern
     . intern/bin/activate
     mkvirtualenv intern
  • (Preferred) Install via pypi

     pip install intern
  • Install via git

    Clone the repository from and run pip install -r requirements.txt from the repository's location on your system.

    Add <repository location> to your PYTHONPATH.

    For example, on a *nix system, if intern was cloned to ~/intern:

    export PYTHONPATH=$PYTHONPATH:~/intern

Getting Started

To quickly get started with intern, check out the wiki:


Full detailed documentation can be found here:


Please submit bug reports, or get in touch using GitHub Issues.