Skip to main content

I'm Leselys, your very elegant RSS reader.

Project description

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.

Project details

Release history Release notifications

This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
leselys-0.2.6.tar.gz (387.8 kB) Copy SHA256 hash SHA256 Source None Jul 27, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page