Contentmatcher

Development quickstart

Setup a database (...). Configure a .env file (see .env.dist) (...).

Install dependencies with pipenv.

$ pipenv install

Run app.py.

$ python app.py

Try it

Usually there is a running instance here.

About

Contentmatcher is a General Intelligence Agency of Ljubljana prototype.

Contentmatcher is hosted by kompot, a librehosters community from Ljubljana.

If you have any questions, feedback or if you would like contribute, you can contact us at gia@kompot.si.

Intstructions

Contentmatcher is a GIA prototype that tries to help you engage with your content and share it with other users. It assumes that you have a heap of content that you would like to reconsider. This heap can take many forms such vast libraries of PDFs on your computer or a long lists of bookmarks.

The app will help you get through this content step by step and continue to show you your content again based on the interest you express as well present you with shared content. If you and at least one more person express a high interest in an item a match will appear on your matches page. There you can send them an email to talk about the item your interested in.

Some definitions:

• An item is a unit of content (like a PDF you upload).
• Items are private by default but they can be shared.
• A collection made up of all your private items and the items shared with you.
• When you start a new session Contentmatcher will create a deck, which is a small part of the collection.

Importing your content

For now the only way to import content is to upload your PDFs. We're figuring out how to add different lists of links like browser bookmarks, liked tweets and "watch later" youtube videos.

Sessions

Going through sessions is the main activity in using Contentmatcher. A session consists of rating and potentially shareing items in a deck. You can adjust the size of your deck in the settings. In sessions you rate items with yes, maybe, no and delete buttons. It's weird because there is no question, maybe think of a question like: "Are you really interested in this item?"

There is also the share button. This will create a new item with this content for all other users, so it will appear in their decks from now on as well.

Matches

If you and at least one other user rate an item with a yes then a match will appear on your matches page. There you can send a email to talk.

Feedback

If you have any questions, feedback, ideas or if you would like contribute, please contact us at gia@kompot.si.

Build instructions

Comming soon...

TODO

Design issues

Sorting and matching

The overlap of this features creates some issues. Interest in terms of sorting is likely lost when an item is read, but it may not be lost in terms of matching.

Features

Links

• cards can be links
• allow importing of links
• db representation of link-cards

Algorithm

• SR-algorithm for decks and appropriate db representation
  • algorithm calculates due cards only with the help of rating history and time of rating.
  • formula for next interval
  • algorithm resets on every 'yes' vote.

UI

• Flash messages should have an approriate color (error is red...)
• Visual cue to distinguish shared vs private cards
• PDF action to view more than 10 pages.