This source is licensed under GPLv3, see LICENSE.txt (Note: Metacademy's content is CC BY SA 3.0).
Metacademy is live at http://www.metacademy.org.
For Windows installation/requirements, please see the README located in /windows. These instructions here presume a *nix or OS X OS.
Python 2.7.XNote: install
python-devif you're using a package manager such as
apt-get. The following command should then print a path. If this command raises an exception, make sure that you have
-devfor your installed version of python installed:
python -c 'from distutils.sysconfig import get_makefile_filename as m; print m()'
Mac OS X and *nix
- Create an empty top-level Metacademy directory in a desired location, e.g.
mkdir -p ~/MyProjects/metacademy.
It will be used for (1) the actual application, (2) storing the database and (3) the respective virtual Python environment.
- Go to the top-level Metacademy directory
From your top-level Metacademy directory, clone the application repo:
git clone https://github.com/metacademy/metacademy-application.git
Go to the
Install the Metacademy application (Note: this project uses a virtual environment for development):
During the process confirm to load the initial dataset with
Your Metacademy project directory now also contains the
Verify the installation
The following tasks are not neccessarily needed to run Metacademy.
Load the public data from metacademy.org
python server/manage.py loaddata dev_utils/graph_data.json
Create a Django superuser
A Django superuser will allow you to login at
/admin to perform additional management tasks.
Given you are still in the
metacademy-application directory, activate the virtual environment first.
Then create the Django superuser.
python server/manage.py createsuperuser
You can leave the virtual environment again simply by invoking
They are needed for some legacy/aux function calls.
Note: These dependencies should already be part of the virtual environment by running
makeabove. Make sure to activate the virtual environment before continuing.
pip install numpy pip install pandas
Some of Metacademy's ancillary functions currently depend on
scipy. Scipy can be tricky to install, so we have made it an optional dependency.
pip install scipy won't work unless you have all of the system-level dependencies.
Please refer to the official Scipy installation instructions to set it up for your Operating System / Linux Distribution.
Once you have
scipy installed on your machine, link its
site-packages folder to your virtual environment's
From within the
meta_venv directory it could read
ln -s /usr/local/lib/python2.7/site-packages/scipy lib/python2.7/site-packages/
or still from within the
metacademy-application directory on a 64 bit RHEL-based system similiar to
ln -s /usr/lib64/python2.7/site-packages/scipy ../meta_venv/lib64/python2.7/site-packages/
Mac OS X and *nix
Start the virtual environment. You must do this for each new session.
Start the development server
python server/manage.py runserver 8080
Note: The initial search may take some time while the backend loads the graph into memory, but all subsequent pages should load much quicker.
If you have any problems with this installation, please submit an issue at https://github.com/metacademy/metacademy-application/issues?state=open.