skip to navigation
skip to content

leselys 0.2.6

I'm Leselys, your very elegant RSS reader.

I’m Leselys, your very elegant RSS reader. Try me right now (password: demo)!

No bullshit apps for Android, iPhone, etc. Just a responsive design and for every device.

Leselys is Heroku ready.



Two requirements: Mongodb and Python.

In order to install leselys you’ll need some dependencies:

sudo apt-get install build-essential python-dev python-setuptools
sudo apt-get install libxslt1-dev libxml2-dev
sudo easy_install pip
sudo easy_install virtualenv

And install your MongoDB.

This is the right way, with virtualenv:

mkdir leselys && cd leselys
virtualenv .
source bin/activate
pip install leselys
leselys init leselys.ini
leselys serve leselys.ini
# In another terminal (in leselys directory)
source bin/activate
leselys worker leselys.ini

Open your browser at http://localhost:5000.


Setting up with Docker is easy. There is no published images on the Docker Hub yet but here’s how to build a set of images easily and quickly using Docker Compose:

git clone
cd leselys
git checkout dockerize
docker-compose up -d

With the configuration in docker-compose.yml you can then visit:

http://localhost:5000/ if you’re on a native Linux Docker host or http://$(docker-machine ip dev):5000/ if you’re on OS X via boot2docker or similar.


Advanced setup with MongoDB for storage and Redis for session on Heroku. You will also need the Heroku Scheduler add-on to refresh your feeds.

All Heroku dependencies like Pymongo, gunicorn and redis are in requirements.txt file, so everything will be installed automagically.

git clone
cd leselys
heroku create
heroku addons:add mongohq:sandbox
heroku addons:add redistogo:nano
heroku addons:add scheduler:standard
heroku addons:open scheduler
# Add "sh && leselys refresh heroku.ini" job every 10 minutes
# And "sh && leselys retention heroku.ini" job every day
git push heroku master

Import your Google Reader OPML file right now!


This is how to update your Leselys (on Heroku):

git pull
git push heroku master
heroku restart

And for the pip way, you just have to go to your virtualenv and run pip install leselys -U and restart Leselys processes.


Storage and session backends are Python modules, you can easily write your own. Take a look at the MongoDB storage backend.

Leselys automagically fetch new stories with it’s refresher worker, and automagically (again), purge our stories database with it’s retention task.

Python 3 support is available, there is just worker with celery which doesn’t work correctly. You can schedule the task with refresh and retention commands. Python 3 is automatically used on Heroku.


License is AGPL3. See LICENSE.

File Type Py Version Uploaded on Size
leselys-0.2.6.tar.gz (md5) Source 2016-07-27 378KB
  • Author: socketubs
  • Home Page:
  • Keywords: rss reader greader
  • License:
    Copyright (C) 2013 Geoffrey Lehée []
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as
    published by the Free Software Foundation, either version 3 of the
    License, or (at your option) any later version.
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    GNU Affero General Public License for more details.
    You should have received a copy of the GNU Affero General Public License
    along with this program. If not, see <>.
  • Package Index Owner: toxinu
  • DOAP record: leselys-0.2.6.xml