Skip to content
I'm Leselys, your very elegant RSS reader.
Branch: master
Clone or download
Latest commit 8ac069a Jul 27, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.



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.

You can’t perform that action at this time.