Sefaria is creating interfaces, apps (like a source sheet builder) and infrastructure (like an API and a structured dataset) for Jewish texts and textual learning. Our demo is up at www.sefaria.org.

You can find outputs of our entire database in Sefaria-Data.

Interested developers should join the sefara-dev mailing list.

For general discussion about the project, please post to the Sefaria Forum.

You can post bugs or request/discuss features on GitHub Issues. Tackling an issue marked as a "Starter Project" is a good way to sink your teeth into Sefaria.

Our complete list of development tasks is stored on our Engineering WorkFlowy. If you're interested in working on a project you see listed here, please email the sefara-dev mailing list.

Most UNIX systems come with a python interpreter pre-installed.

Go to the Python Download Page and download and install python. Add the python directory to your OS' PATH variable. See here

Use instructions here and then make sure that the scripts sub folder of the python installation directory is also in PATH.

If you don't already have them, install virtualenv and pip. Then use them to install the required Python packages.

virtualenv venv --distribute
source venv/bin/activate
pip install -r requirements.txt

Now you should see (venv) in front of your command prompt. The second command sets your shell to use the Python virtual environment that you've just created. This is something that you have to run everytime you open a new shell and want to run the Sefaria demo. You can always tell if you're in the virtual environment by checking if (venv) is at the beginning of your command prompt. If for some reason you don't want to use virtualenv, just run the third command.

If you see an error when running pip install -r requirements.txt about a missing 'python.h' file, you'll need to install the Python development libraries.

On Debian systems:

sudo apt-get install python-dev

On Fedora systems:

sudo yum install python-devel

After installing the Python development libraries, run pip install -r requirements.txt again.

cd sefaria
cp local_settings_example.py local_settings.py
vim local_settings.py

Replace the placeholder values with values with those matching your enviornment. Choose a name for you local database (sefaria will be the default created by mongorestore below). You can leave SEFARIA_DB_USER ad SEFARIA_DB_PASSWORD blank if you don't need to run authentication on mongo.

create a directory called "log" under the project folder. Make sure that the server user has write access to it by using a command such as chmod 777 (only on the log directory!!)

If you don't already have it, install MongoDB. The data dump included in Sefaria-Data requires MongoDB version 2.6 or later. To get Mongo running:

mongod

A MongoDB dump of our database is available via DropBox. You can find it link from our Sefaria-Data repo. Place the dump directory within Sefaria-Data, then:

cd Sefaria-Data
mongorestore --drop

This will create (or overwrite) a mongo database called sefaria.

manage.py is used to run and to manage the local server. Is is located in the root directory of the Sefaria-Project code base.

Django auth features run on a seperate database. To init this database and set up Django's auth system, switch to the root directory of the Sefaria-Project code base, and run:

python manage.py syncdb

python manage.py runserver

Some of the most important code is found in:

• static/js/reader.js - JS for reader app
• static/js/sheets.js - JS for source sheet builder
• static/js/util.js - JS shared across apps
• sefaria/reader/views.py - view methods for almost all API calls
• sefaria/sheets.py - backend for source sheets
• sefaria/model/ - Class based resource and logical models for almost all Sefaria data

Some still used code that is on its way to being retired is found in:

• sefaria/history.py - revision history for texts
• sefaria/texts.py - backend core for manipulating texts

The shell script cli will invoke a python interpreter with the core models loaded, and can be used as a standalone interface to texts or for testing.

$ ./cli
>>> p = LinkSet(Ref("Genesis 13"))
>>> p.count()
226

Though soon to be retired, some functionality is still in texts.py which can also be accessed from the cli as texts.

$ ./cli
>>> texts.get_text("Kohelet 4:9")

GPL