Pjuu is under very active development at this early stage in its life. A lot
may change between versions until we are happy with it :)
An open-source social networking application which runs https://pjuu.com.
This is an open source project released under the GNU AGPLv3 license. See LICENSE for more details or visit the official GNU page at http://www.gnu.org/licenses/agpl-3.0.html.
This is the primary code base for https://pjuu.com, the website is deployed directly from this respository.
The main goal of Pjuu as an application is privacy.
Pjuu is written in Python/Flask and uses Redis and MongoDB as the data stores.
Getting started working on Pjuu or deploying it yourself is quite easy if you are familiar with Python. We will only cover development here and the following documentation is for Debian 8 (Jessie) Linux (we are big fans). Pjuu should work with and any other Linux distribution, however you will need to change the commands to fit. It has also been tested with FreeBSD, but this is beyond the scope of the README.
We are presuming a fresh installation, this will setup the environment:
$ sudo apt-get update
$ sudo apt-get install build-essential python-dev python-setuptools redis-server mongodb
# Install the Pillow dependencies
$ sudo apt-get install libtiff5-dev libjpeg62-turbo-dev zlib1g-dev libfreetype6-dev liblcms2-dev libwebp-dev tcl8.5-dev tk8.5-dev python-tk
$ sudo easy_install virtualenv
$ git clone https://github.com/pjuu/pjuu.git
$ cd pjuu
$ virtualenv venv
$ source venv/bin/activate
$ pip install -r requirements-dev.txt
Running the unit tests with coverage:
$ make test
Obtain a code coverage report
$ make coverage
Checking code quality and PEP8 compliance:
$ make flake
Running the development server (CherryPy):
$ make run
You can view the site by visiting: http://localhost:5000
You can now play with the code base :)
IMPORTANT You do NOT need to setup an SMTP server. To activate your an account you can look in the response header for X-Pjuu-Token. If you copy this and visit /activate/<token>
that will give the same effect as pressing an e-mail link. The same applies for any other action requiring confirmation (forgotten password), it will however be a different URL you need to append the token to.
This only works if TESTING = True
in your settings.
We are open to all pull requests. Spend some time taking a look around, locate a bug, design issue or spelling mistake then send us a pull request :)
All software has bugs in and Pjuu is no different. These may have security implications. If you find one that you suspect could allow you to do something you shouldn't be able to please do not post it as an issue on Github. We would really appreciate it if you could send an e-mail to security@pjuu.com with the relevant details.
James Rand - illustrating our Otter logo :)