https://github.com/brickfrog/ankigen
Gradio application using LLMs to generate csv/apkg to aid with memorizing topics in Anki
https://github.com/brickfrog/ankigen
anki gradio
Last synced: 6 months ago
JSON representation
Gradio application using LLMs to generate csv/apkg to aid with memorizing topics in Anki
- Host: GitHub
- URL: https://github.com/brickfrog/ankigen
- Owner: brickfrog
- License: bsd-2-clause
- Created: 2024-09-30T23:55:06.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-02-15T22:45:37.000Z (8 months ago)
- Last Synced: 2025-04-10T09:12:42.652Z (6 months ago)
- Topics: anki, gradio
- Language: Python
- Homepage: https://huggingface.co/spaces/brickfrog/ankigen
- Size: 326 KB
- Stars: 22
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---
title: AnkiGen
emoji: 📚
app_file: app.py
requirements: requirements.txt
python: 3.12
sdk: gradio
sdk_version: 5.13.1
---
# AnkiGen - Anki Card Generator
AnkiGen is a Gradio-based web application that generates Anki-compatible CSV files using Large Language Models (LLMs) based on user-specified subjects and preferences.
## Features
- Generate Anki cards for various subjects
- Customizable number of topics and cards per topic
- User-friendly interface powered by Gradio
- Exports to CSV for manual import or .apkg format with out of the box css styling
- Utilizes OpenAI's structured output to mimic chain of thought to minimize hallucinations
## TODO
- [ ] cloze cards? (checkbox?)
- [ ] File upload / parsing longer texts / books as input?
- [ ] Novelty Fields / Custom? [ELI5], etc.
## Screenshot
## Installation for Local Use
Preferred usage: [uv](https://github.com/astral-sh/uv)
1. Clone this repository:
```bash
git clone https://github.com/brickfrog/ankigen.git
cd ankigen
uv venv
```
2. Install the required dependencies:
```bash
uv pip install -r requirements.txt
```
3. Set up your OpenAI API key (required for LLM functionality).
## Usage
1. Run the application:
```bash
uv run gradio app.py --demo-name ankigen
```
2. Open your web browser and navigate to the provided local URL (typically `http://127.0.0.1:7860`).
3. In the application interface:
- Enter your OpenAI API key
- Specify the subject you want to create cards for
- Adjust the number of topics and cards per topic
- (Optional) Add any preference prompts
- Click "Generate Cards"
4. Review the generated cards in the interface.
5. Click "Export to CSV" to download the Anki-compatible file or Export to Anki Deck to export as a .apkg that can be imported into Anki.
## Development
This project is built with:
- Python 3.12
- Gradio 5.13.1
To contribute or modify:
1. Make your changes in `app.py`
2. Update `requirements.txt` if you add new dependencies
3. Test thoroughly before submitting pull requests
## License
BSD 2.0
## Acknowledgments
- This project uses the Gradio library (https://gradio.app/) for the web interface
- Card generation is powered by OpenAI's language models