<p align="center"> <a href="https://github.com/open-spaced-repetition/fsrs4anki/wiki"> <img src="https://github.com/open-spaced-repetition/fsrs4anki/assets/32575846/9efb2ca5-51bd-411d-9694-a77b09f51fa7" width="150" height="150" alt="FSRS4Anki"> </a> </p>

<div align="center">

FSRS4Anki

✨ A modern spaced-repetition scheduler for Anki based on the Free Spaced Repetition Scheduler algorithm ✨

</div>

<p align="center"> <a href="https://raw.githubusercontent.com/open-spaced-repetition/fsrs4anki/main/LICENSE"> <img src="https://img.shields.io/github/license/open-spaced-repetition/fsrs4anki" alt="license"> </a> <a href="https://github.com/open-spaced-repetition/fsrs4anki/releases/latest"> <img src="https://img.shields.io/github/v/release/open-spaced-repetition/fsrs4anki?color=blueviolet" alt="release"> </a> </p>

Table of contents

• Introduction
• How to Get Started?
• Add-on Compatibility
• Contribute
  • Contributors
• Developer Resources
• Stargazers Over Time
• Acknowledgements

Introduction

FSRS4Anki (Free Spaced Repetition Scheduler for Anki) consists of two main parts: the scheduler and the optimizer.

• The scheduler replaces Anki's built-in scheduler and schedules the cards according to the FSRS algorithm.
• The optimizer uses machine learning to learn your memory patterns and finds parameters that best fit your review history. For details about the working of the optimizer, please read the mechanism of optimization.

Research on the FSRS algorithm follows the path pioneered by Maimemo: data-driven, balancing interpretability and verifiability. See also:

• Maimemo: A Stochastic Shortest Path Algorithm for Optimizing Spaced Repetition Scheduling (free access) [中文版], and
• Maimemo: Optimizing Spaced Repetition Schedule by Capturing the Dynamics of Memory (Google Scholar) [中文版].

FSRS Helper is an Anki add-on that complements the FSRS4Anki Scheduler. You can read about it here: https://github.com/open-spaced-repetition/fsrs4anki-helper

How to Get Started?

If you are using Anki 23.10 or newer, refer to this section of the Anki manual.

If you are using an older version of Anki, refer to this tutorial.

Note that setting up FSRS is much easier in Anki 23.10 or newer.

Add-on Compatibility

Some add-ons can cause conflicts with FSRS. As a general rule of thumb, if an add-on affects a card's intervals, it shouldn't be used with FSRS.

Let me know via issues if you want me to check compatibility between FSRS and some add-on.

Contribute

You can contribute to FSRS4Anki by beta testing, submitting code, or sharing your data. If you want to share your data with me, please fill out this form: https://forms.gle/KaojsBbhMCytaA7h8

Contributors

<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --> <!-- ALL-CONTRIBUTORS-BADGE:END -->

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tbody> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Expertium"><img src="https://avatars.githubusercontent.com/u/83031600?v=4?s=100" width="100px;" alt="Expertium"/><br />_{<b>Expertium</b>}</a><br /><a href="https://github.com/open-spaced-repetition/fsrs4anki/commits?author=Expertium" title="Tests">⚠️</a> <a href="https://github.com/open-spaced-repetition/fsrs4anki/commits?author=Expertium" title="Documentation">📖</a> <a href="#data-Expertium" title="Data">🔣</a> <a href="#ideas-Expertium" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/open-spaced-repetition/fsrs4anki/issues?q=author%3AExpertium" title="Bug reports">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/user1823"><img src="https://avatars.githubusercontent.com/u/92206575?v=4?s=100" width="100px;" alt="user1823"/><br />_{<b>user1823</b>}</a><br /><a href="https://github.com/open-spaced-repetition/fsrs4anki/commits?author=user1823" title="Tests">⚠️</a> <a href="https://github.com/open-spaced-repetition/fsrs4anki/commits?author=user1823" title="Documentation">📖</a> <a href="#data-user1823" title="Data">🔣</a> <a href="#ideas-user1823" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/open-spaced-repetition/fsrs4anki/issues?q=author%3Auser1823" title="Bug reports">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="http://chrislongros.com"><img src="https://avatars.githubusercontent.com/u/98426896?v=4?s=100" width="100px;" alt="Christos Longros"/><br />_{<b>Christos Longros</b>}</a><br /><a href="#data-chrislongros" title="Data">🔣</a> <a href="#content-chrislongros" title="Content">🖋</a></td> </tr> </tbody> </table>

<!-- markdownlint-restore --> <!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END --> <!-- prettier-ignore-start --> <!-- markdownlint-disable -->

<!-- markdownlint-restore --> <!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->

Developer Resources

If you're a developer considering using the FSRS algorithm in your own projects, we've curated some valuable resources for you. Check out the Awesome FSRS repository, where you'll find:

• FSRS implementations in various programming languages
• Related papers and research
• Example applications using FSRS
• Other algorithms and resources related to spaced repetition systems

This carefully curated list will help you better understand FSRS and choose the right implementation for your project. We encourage you to explore these resources and consider contributing to the FSRS ecosystem.

Research Resources

For those new to spaced repetition algorithms, we recommend starting with our comprehensive guide: Spaced Repetition Algorithm: A Three-Day Journey from Novice to Expert

Dive deeper into the academic foundations of FSRS and spaced repetition through our curated collection of Datasets, Code & Research Papers

Explore our extensive collection of Research Notebooks documenting detailed analyses and experiments with FSRS and spaced repetition algorithms

Stargazers Over Time

<a href="https://star-history.dera.page/#open-spaced-repetition/fsrs4anki&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=open-spaced-repetition/fsrs4anki&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=open-spaced-repetition/fsrs4anki&type=Date" /> <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=open-spaced-repetition/fsrs4anki&type=Date" /> </picture> </a>

Acknowledgements

A special thanks to 墨墨背单词 (MaiMemo) for their support of FSRS development by allowing its research engineer, Jarrett Ye, to dedicate part of his working hours to this open-source project. This greatly helps in the continuous improvement and maintenance of FSRS for the benefit of the entire community.

We would also like to extend our sincere gratitude to Damien Elmes of Ankitects for his invaluable technical support, and to the AnkiWeb users for the review history dataset. Without their collective contribution, FSRS would not have achieved its current level of popularity and influence.